Folder.GetStorage method (Outlook)
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.
Hinweise
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:
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.
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.
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
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.