Ein Objekt, mit dem Skripts eine potenziell große Ordnersammlung durchlaufen können. Ordner
Iteratoren können über DriveApp
, File
oder Folder
aufgerufen werden.
// 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()); }
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. |
hasNext() | Boolean | Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | Folder | Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. |
Detaillierte Dokumentation
getContinuationToken()
Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. Diese Methode ist nützlich, wenn bei einer einzelnen Ausführung die maximale Ausführungszeit überschritten würde. Fortsetzungs-Tokens sind in der Regel eine Woche lang gültig.
Rückflug
String
: ein Fortsetzungstoken, mit dem diese Iteration mit den Elementen fortgesetzt werden kann,
im Iterator blieben, als das Token generiert wurde
hasNext()
next()
Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. Löst eine Ausnahme aus, wenn keine Elemente vorhanden sind bleiben.
Rückflug
Folder
– das nächste Element in der Sammlung