Class FolderIterator

FolderIterator

كائن يسمح للنصوص البرمجية بتكرار مجموعة من المجلدات التي يُحتمل أن تكون كبيرة. يمكن الوصول إلى مكرّرات المجلدات من DriveApp أو File أو Folder.

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

الطُرق

الطريقةنوع الإرجاعوصف قصير
getContinuationToken()Stringيحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق.
hasNext()Booleanتحدِّد هذه السياسة ما إذا كان طلب next() سيؤدي إلى عرض سلعة.
next()Folderالحصول على العنصر التالي في مجموعة الملفات أو المجلدات.

المستندات التفصيلية

getContinuationToken()

يحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق. تكون هذه الطريقة مفيدة إذا كانت معالجة التكرار في عملية تنفيذ واحدة سيتجاوز الحد الأقصى لوقت التنفيذ. وتكون الرموز المميّزة للمتابعة صالحة بشكل عام لمدة أسبوع واحد.

تذكرة ذهاب وعودة

String - رمز مميّز للمتابعة يمكن استخدامه لاستئناف عملية التكرار هذه مع العناصر التي بقيت في المكرّر عند إنشاء الرمز المميّز


hasNext()

تحدِّد هذه السياسة ما إذا كان طلب next() سيؤدي إلى عرض سلعة.

تذكرة ذهاب وعودة

Booleantrue إذا كانت next() ستعيد عنصرًا، false إذا لم يتم إرجاعها


next()

الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. تطبيق استثناء في حال عدم وجود أي عناصر.

تذكرة ذهاب وعودة

Folder — العنصر التالي في المجموعة