Zugreifen auf lösungsspezifische Daten, die als ausgeblendete Nachricht in einem Ordner gespeichert sind
Dieses Beispiel zeigt die Verwendung des StorageItem -Objekts zum Abrufen von Daten, die als ausgeblendete Nachricht einer bestimmten Nachrichtenklasse in einem Ordner gespeichert sind.
Beispiel
Das StorageItem-Objekt wird üblicherweise verwendet, um lösungsspezifische Daten auszublenden, die nicht programmgesteuert angezeigt werden können. In einer Exchange-Umgebung wird das StorageItem-Objekt zum Roaming von Lösungseinstellungen verwendet und um sicherzustellen, dass diese Einstellungen online und offline verfügbar sind. Sie können dem StorageItem-Objekt eine benutzerdefinierte Nachrichtenklasse zuweisen oder das Objekt durch den Betreff identifizieren.
The following code sample retrieves the XML data that is stored as a hidden message in the Calendar folder with the message class equal to IPM.Configuration.WorkHours.
Das PropertyAccessor -Objekt gibt die XML-Daten in Form eines Objekts zurück, das anstelle einer Zeichenkettendarstellung der XML-Daten einen Datenstrom enthält. Der Datenstrom wird im Codebeispiel mithilfe von System.Text.Encoding.Ascii.GetString in eine Zeichenfolge umgewandelt.
Wenn Sie Visual Studio verwenden, um dieses Codebeispiel zu testen, müssen Sie der Microsoft Outlook 15.0-Objektbibliothekkomponente zuerst einen Verweis hinzufügen und die Outlook-Variable angeben, wenn Sie den Microsoft.Office.Interop.Outlook-Namespace importieren. Die Anweisung Imports oder using darf im Codebeispiel nicht direkt vor den Funktionen stehen, sondern muss vor der öffentlichen Class-Deklaration hinzugefügt werden. Die folgenden Codezeilen zeigen, wie Sie den Import und die Zuweisung in Visual Basic und C# vornehmen.
Imports Outlook = Microsoft.Office.Interop.Outlook
using Outlook = Microsoft.Office.Interop.Outlook;
Private Function GetWorkHoursXML() As String
Try
Dim storage As Outlook.StorageItem = _
Application.Session.GetDefaultFolder( _
Outlook.OlDefaultFolders.olFolderCalendar).GetStorage( _
"IPM.Configuration.WorkHours", _
Outlook.OlStorageIdentifierType.olIdentifyByMessageClass)
Dim pa As Outlook.PropertyAccessor = storage.PropertyAccessor
' PropertyAccessor will return a byte array for this property
Dim rawXmlBytes As Byte() = CType(pa.GetProperty( _
"http://schemas.microsoft.com/mapi/proptag/0x7C080102"), _
Byte())
' Use Encoding to convert the array to a string
Return System.Text.Encoding.ASCII.GetString(rawXmlBytes)
Catch
Return String.Empty
End Try
End Function
private string GetWorkHoursXML()
{
try
{
Outlook.StorageItem storage =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderCalendar).GetStorage(
"IPM.Configuration.WorkHours",
Outlook.OlStorageIdentifierType.olIdentifyByMessageClass);
Outlook.PropertyAccessor pa = storage.PropertyAccessor;
// PropertyAccessor will return a byte array for this property
byte[] rawXmlBytes = (byte[])pa.GetProperty(
"http://schemas.microsoft.com/mapi/proptag/0x7C080102");
// Use Encoding to convert the array to a string
return System.Text.Encoding.ASCII.GetString(rawXmlBytes);
}
catch
{
return string.Empty;
}
}