Class FolderIterator
FolderIterator
عنصر يسمح للنصوص البرمجية بالتكرار على مجموعة كبيرة من المجلدات. يمكن الوصول إلى مصنّفات
المجلدات من DriveApp أو File أو Folder.
// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
const folder = folders.next();
Logger.log(folder.getName());
}
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getContinuationToken() | String | تحصل على رمز مميّز يمكن استخدامه لاستئناف هذه المحاولة في وقت لاحق. |
hasNext() | Boolean | لتحديد ما إذا كانت المكالمة إلى next() ستؤدي إلى عرض عنصر |
next() | Folder | الحصول على العنصر التالي في مجموعة الملفات أو المجلدات |
مستندات تفصيلية
getContinuationToken()
تحصل على رمز مميّز يمكن استخدامه لاستئناف هذه المحاولة في وقت لاحق. تكون هذه الطريقة مفيدة
إذا كانت معالجة أداة تكرار في عملية تنفيذ واحدة تتجاوز الحد الأقصى لعدد مرات التنفيذ.
تكون الرموز المميزة للمتابعة صالحة بشكل عام لمدة أسبوع واحد.
الإرجاع
String: رمز مميّز للمتابعة يمكن استخدامه لاستئناف هذه التكرارات باستخدام العناصر التي ظلت في أداة التكرار عند إنشاء الرمز المميّز
hasNext()
لتحديد ما إذا كانت المكالمة إلى next() ستؤدي إلى عرض عنصر
الإرجاع
Boolean: true إذا كان next() سيعرض عنصرًا، false إذا لم يكن الأمر كذلك
next()
الحصول على العنصر التالي في مجموعة الملفات أو المجلدات يُعرِض استثناءً إذا لم تبق أي عناصر.
الإرجاع
Folder: العنصر التالي في المجموعة
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`FolderIterator` enables scripts to iterate through a large collection of folders within Google Drive."],["It provides methods like `hasNext()` to check for more folders, `next()` to retrieve the next folder, and `getContinuationToken()` for handling lengthy iterations."],["Developers can utilize `FolderIterator` with `DriveApp`, `File`, or `Folder` objects to access and process folders programmatically."]]],["FolderIterator allows iterating over a large collection of folders. Key actions include using `hasNext()` to check for the next item and `next()` to retrieve it. `getContinuationToken()` provides a token to resume iteration later, helpful for large collections. The example shows how to log every folder's name in a user's Drive, demonstrating iteration through the folder collection. The iterator returns folder objects and can throw an exception if no items remain.\n"]]
