Folder.GetStorage method (Outlook)

  • Artikel

Ruft ein StorageItem -Objekt für das übergeordnete Folder -Objekt ab, um Daten für eine Outlook-Lösung zu speichern.

Syntax

Ausdruck. GetStorage( _StorageIdentifier_ , _StorageIdentifierType_ )

Ausdruck Eine Variable, die ein Folder-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
StorageIdentifier Erforderlich String Ein Bezeichner für das StorageItem -Objekt; Je nach Typ des Bezeichners kann der Wert eine Eintrags-ID, eine Nachrichtenklasse oder einen Betreff darstellen.
StorageIdentifierType Erforderlich OlStorageIdentifierType Gibt den Bezeichnertyp für das StorageItem -Objekt.

Rückgabewert

Ein StorageItem -Objekt, das zum Speichern von Daten für eine Lösung verwendet wird.

HinwBemerkungeneise

Die GetStorage-Methode ruft ein StorageItem-Objekt für ein Folder-Objekt unter Verwendung des von StorageIdentifier angegebenen Bezeichners ab und weist den bezeichnertyp auf, der durch StorageIdentifierType angegeben wird. Das StorageItem-Objekt ist ein ausgeblendetes Element im Ordner, der mit dem Konto wechselt und ist online und offline verfügbar.

Wenn Sie die EntryID für das StorageItem-Objekt mithilfe des OlIdentifyByEntryID-Werts für StorageIdentifierType angeben, gibt die GetStorage-Methode das StorageItem-Objekt mit der angegebenen EntryID zurück. Wenn kein StorageItem-Objekt mit dieser EntryID gefunden wird oder wenn das StorageItem-Objekt nicht vorhanden ist, löst die GetStorage-Methode einen Fehler aus.

Wenn Sie die Nachrichtenklasse für das StorageItem-Objekt mithilfe des OlIdentifyByMessageClass-Werts für StorageIdentifierType angeben, gibt die GetStorage-Methode das StorageItem-Objekt mit der angegebenen Nachrichtenklasse zurück. Wenn mehrere Elemente mit der gleichen Nachrichtenklasse vorhanden sind, gibt die GetStorage -Methode das Element mit den neuesten PR_LAST_MODIFICATION_TIME zurück. Wenn kein StorageItem-Objekt mit der angegebenen Nachrichtenklasse vorhanden ist, erstellt die GetStorage-Methode ein neues StorageItem-Objekt mit der Nachrichtenklasse, die von StorageIdentifier angegeben wurde.

Wenn Sie den Betreff des StorageItem-Objekt angeben, gibt die GetStorage (Methode) mit dem Betreff in der Anruf GetStorage angegebenen StorageItem-Objekt zurück. Wenn mehrere Elemente mit dem gleichen Betreff vorhanden sind, gibt die GetStorage -Methode das Element mit den neuesten PR_LAST_MODIFICATION_TIME zurück. Wenn kein StorageItem mit dem angegebenen Subject vorhanden ist, erstellt die GetStorage-Methode ein neues StorageItem-Objekt mit dem vonStorageIdentifier angegebenen Subject.

GetStorage gibt einen Fehler zurück, wenn der Speichertyp des Ordners nicht unterstützt wird. Die folgenden Speicher zurück einen Fehler, wenn GetStorage aufgerufen wird:

  • Hotmail-Speicher

  • IMAP-Speicher (Internet Message Access Protocol)

  • Delegieren der Speicher

  • Informationsspeicher für Öffentliche Ordner

Die Größe der, die neu erstellten StorageItem-Objekt ist NULL (0) bis Sie einen expliziten Aufruf für die Speichern -Methode des Elements.

Weitere Informationen zum Speichern von Daten für eine Lösung finden Sie unter Speichern von Daten für Lösungen.

Beispiel

Im folgenden Codebeispiel in Visual Basic für Applikationen zeigt, wie das StorageItem -Objekt zum Speichern privater Lösungsdaten verwendet. Sie speichert die Daten in eine benutzerdefinierte Eigenschaft ein StorageItem -Objekt im Ordner Posteingang. Im folgenden werden die Schritte beschrieben:

  1. Das Codebeispiel ruft GetStorage um ein vorhandenes StorageItem -Objekt mit dem Betreff "My Private Storage" im Posteingang zu erhalten. Wenn keine StorageItem diesen Betreff bereits vorhanden ist, erstellt GetStorage ein StorageItem -Objekt mit diesem Thema.

  2. Wenn das StorageItem-Objekt neu erstellt wird, wird das Codebeispiel eine benutzerdefinierte Eigenschaft "Order Number" für das Objekt erstellt. Beachten Sie, dass "Order Number" ein-Eigenschaft des ausgeblendetes Element im Posteingang.

  3. Im Codebeispiel wird dann "Order Number" ein Wert zugewiesen und speichert das StorageItem -Objekt.

Sub AssignStorageData() 
 Dim oInbox As Outlook.Folder 
 Dim myStorage As Outlook.StorageItem 
 
 Set oInbox = Application.Session.GetDefaultFolder(olFolderInbox) 
 ' Get an existing instance of StorageItem, or create new if it doesn't exist 
 Set myStorage = oInbox.GetStorage("My Private Storage", olIdentifyBySubject) 
 ' If StorageItem is new, add a custom property for Order Number 
 If myStorage.Size = 0 Then 
 myStorage.UserProperties.Add "Order Number", olNumber 
 End If 
 ' Assign a value to the custom property 
 myStorage.UserProperties("Order Number").Value = 100 
 myStorage.Save 
End Sub

Siehe auch

Folder-Objekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.