Доступ к данным решений, хранящимся в скрытом сообщении в папке
В этом примере показан способ применения объекта StorageItem для извлечения данных, хранящихся в папке в виде скрытого сообщения определенного класса.
Пример
Объект StorageItem обычно используется для скрытия данных решения, которые не удается отобразить программным методом. В среде Exchange объект StorageItem служит для роуминга параметров решения и обеспечения доступности этих настроек в Интернете и в автономном режиме. Настраиваемый класс сообщений можно присвоить объекту StorageItem, либо идентифицировать объект по теме.
В следующем примере кода извлекаются данные XML, сохраненные в виде скрытого сообщения класса IPM.Configuration.WorkHours в папке "Календарь".
Объект PropertyAccessor возвращает XML в виде объекта, содержащего поток байт, а не строковое представление XML. Для преобразования потока байт в строку в примере кода применяется System.Text.Encoding.Ascii.GetString.
Если для тестирования этого примера кода вы используете Visual Studio, сначала добавьте ссылку на компонент библиотеки объектов Microsoft Outlook 15.0 и укажите переменную Outlook при импорте пространства имен Microsoft.Office.Interop.Outlook. Инструкция Imports или using не должна идти непосредственно перед функциями в примере кода, но ее нужно добавить перед объявлением общедоступного класса. В следующих строках кода показано, как выполнить импорт и назначение в Visual Basic и C#.
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;
}
}