GetItemType Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die GetItemType -Klasse stellt eine Anforderung zum Abrufen von Elementen aus einem Postfach in der Exchange-Datenbank dar.
public ref class GetItemType : ExchangeWebServices::BaseRequestType
public class GetItemType : ExchangeWebServices.BaseRequestType
Public Class GetItemType
Inherits BaseRequestType
- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie Sie zwei Elemente aus der Exchange-Datenbank abrufen. Die Anforderung verwendet das Standardantwort-Shape mit der Vertraulichkeitseigenschaft, die als zusätzliche Eigenschaft zurückgegeben wird. Die Antwort wird auf E-Mail-Nachrichten und Kalenderelemente überprüft. Beachten Sie folgendes: Wenn die einzigen Eigenschaften, auf die zugegriffen wird, in der Basisklasse ItemType enthalten sind, ist die Umwandlung in den entsprechenden Typ möglicherweise nicht erforderlich.
static void GetItem(ExchangeServiceBinding esb)
{
// Create the request.
GetItemType request = new GetItemType();
// Create the response shape.
ItemResponseShapeType responseShape = new ItemResponseShapeType();
responseShape.BodyType = BodyTypeResponseType.Text;
responseShape.BodyTypeSpecified = true;
responseShape.BaseShape = DefaultShapeNamesType.Default;
// Add more properties to the request.
PathToUnindexedFieldType[] sensitivity = new PathToUnindexedFieldType[1];
sensitivity[0] = new PathToUnindexedFieldType();
sensitivity[0].FieldURI = UnindexedFieldURIType.itemSensitivity;
responseShape.AdditionalProperties = sensitivity;
// Add the response shape to the request.
request.ItemShape = responseShape;
// Identify the items to get.
ItemIdType[] items = new ItemIdType[2];
items[0] = new ItemIdType();
items[0].Id = "AAAlAE1BQG1";
items[0].ChangeKey = "DwAAABYAAAA";
items[1] = new ItemIdType();
items[1].Id = "AAAlAE1BQG1";
items[1].ChangeKey = "DwAAABYAAAA";
// Add items to the request.
request.ItemIds = items;
try
{
// Send the request and get the response.
GetItemResponseType resp = esb.GetItem(request);
ArrayOfResponseMessagesType aormt = resp.ResponseMessages;
ResponseMessageType[] rmta = aormt.Items;
foreach (ResponseMessageType rmt in rmta)
{
ItemInfoResponseMessageType iirmt = (rmt as ItemInfoResponseMessageType);
ArrayOfRealItemsType aorit = iirmt.Items;
ItemType[] myItems = aorit.Items;
// Determine the type for each item and cast to the approriate type.
foreach (ItemType it in myItems)
{
// Check whether it is an e-mail.
if (it is MessageType)
{
MessageType message = (it as MessageType);
}
// Determine whether it is a calendar item.
else if (it is CalendarItemType)
{
CalendarItemType calendar = (it as CalendarItemType);
}
else
{
// Check for other item types.
}
}
}
}
catch (Exception e)
{
throw new Exception("GetItem failed");
}
}
Hinweise
Die GetItem- und FindItem-Vorgänge stellen einen ähnlichen Satz von Informationen bereit. Der GetItem-Vorgang wird verwendet, um Elemente abzurufen, nachdem sie mithilfe von FindItem-, GetEvents- oder SyncFolderItems-Vorgängen gefunden wurden.
GetItem gibt zusätzliche Eigenschaften zurück, die nicht von FindItem zurückgegeben werden. Die folgende Tabelle zeigt Eigenschaften, die nicht von FindItem zurückgegeben werden, aber von GetItem zurückgegeben werden.
Attachments[Ex15WebSvcsOtherRef] |
Categories[Ex15WebSvcsOtherRef] |
ReplyTo |
Text |
CcRecipients |
ResponseObjects |
BccRecipients |
InternetMessageHeaders |
ToRecipients |
Konstruktoren
GetItemType() |
Der GetItemType Konstruktor initialisiert eine neue Instanz der GetItemType -Klasse. |
Eigenschaften
ItemIds |
Die ItemIds -Eigenschaft ruft die Auflistung der abzurufenden Elemente ab oder legt sie fest. |
ItemShape |
Die ItemShape -Eigenschaft ruft die Antwortform der GetItem-Antwort ab oder legt sie fest. |