CreateItemType Klasse

Referenz

Definition

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

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 CreateItemType -Klasse stellt eine Anforderung zum Erstellen eines Elements oder Antwortobjekts dar.

public ref class CreateItemType : ExchangeWebServices::BaseRequestType

public class CreateItemType : ExchangeWebServices.BaseRequestType

Public Class CreateItemType
Inherits BaseRequestType

Vererbung: Object

BaseRequestType
CreateItemType

Beispiele

Das folgende Codebeispiel zeigt eine CreateItem-Anforderung, die eine einzelne E-Mail erstellt, an mehrere Empfänger sendet und eine Kopie davon im Standardordner Gesendete Elemente speichert.

static void CreateEmail()
{
    // Create the CreateItem request.
    CreateItemType createEmailRequest = new CreateItemType();

    // Specifiy how the e-mail will be handled.
    createEmailRequest.MessageDisposition = MessageDispositionType.SendAndSaveCopy;
    createEmailRequest.MessageDispositionSpecified = true;

    // Specify the location of sent items.
    createEmailRequest.SavedItemFolderId = new TargetFolderIdType();
    DistinguishedFolderIdType sentitems = new DistinguishedFolderIdType();
    sentitems.Id = DistinguishedFolderIdNameType.sentitems;
    createEmailRequest.SavedItemFolderId.Item = sentitems;

    // Create the array of items.
    createEmailRequest.Items = new NonEmptyArrayOfAllItemsType();

    // Create a single e-mail message.
    MessageType message = new MessageType();
    message.Subject = "Daily Report";
    message.Body = new BodyType();
    message.Body.BodyType1 = BodyTypeType.Text;
    message.Body.Value = "(1) Handled customer issues, (2) Saved the world.";
    message.ItemClass = "IPM.Note";
    message.Sender = new SingleRecipientType();
    message.Sender.Item = new EmailAddressType();
    message.Sender.Item.EmailAddress = "user1@example.com";
    message.ToRecipients = new EmailAddressType[1];
    message.ToRecipients[0] = new EmailAddressType();
    message.ToRecipients[0].EmailAddress = "user2@example.com";
    message.Sensitivity = SensitivityChoicesType.Normal;
    message.SensitivitySpecified = true;
    message.Importance = ImportanceChoicesType.High;
    message.ImportanceSpecified = true;

    // Add the message to the array of items to be created.
    createEmailRequest.Items.Items = new ItemType[1];
    createEmailRequest.Items.Items[0] = message;

    try
    {
        // Create the service binding.
        // Identify the service and the user.
        ExchangeServiceBinding esb = new ExchangeServiceBinding();
        esb.Credentials = new NetworkCredential("username", "password", "domain");
        esb.Url = @"https://ExchangeServer.com/EWS/Exchange.asmx";

        // Send a CreateItem request and get the CreateItem response.
        CreateItemResponseType createItemResponse = esb.CreateItem(createEmailRequest);
        ArrayOfResponseMessagesType responseMessages = createItemResponse.ResponseMessages;

        // Access the response message.
        ResponseMessageType responseMessage = responseMessages.Items[0];
        // Determine whether the request was a success.
        if (responseMessages.Items[0].ResponseClass == ResponseClassType.Error)
        {
            throw new Exception(responseMessages.Items[0].MessageText);
        }
        if (responseMessage is ItemInfoResponseMessageType)
        {
            ItemInfoResponseMessageType createItemResp = (responseMessage as ItemInfoResponseMessageType);
            ArrayOfRealItemsType aorit = createItemResp.Items;

            // Determine whether there are items in response.
            if (aorit.Items != null)
            {
                foreach (ItemType item in aorit.Items)
                {
                    if (item is ItemType)
                    {
                        ItemType myItem = (item as ItemType);
                    }
                    if (item is MessageType)
                    {
                        MessageType myMessage = (item as MessageType);
                    }
                    // TODO: Add logic to check and cast for all other types.
                }
            }
        }
        else
        {
            Console.WriteLine("Item(s) created");
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(e.Message);
    }
}

Hinweise

Wird CreateItemType verwendet, um Antwortobjekte und -elemente in der Exchange-Datenbank zu erstellen. In der folgenden Tabelle werden die Elemente und Antwortobjekte beschrieben, die mit CreateItemTypeerstellt werden können.

ItemType	Stellt ein generisches Element dar, das in der Exchange-Datenbank erstellt werden soll.
MessageType	Stellt eine E-Mail-Nachricht dar, die in der Exchange-Datenbank erstellt werden soll.
TaskType	Stellt eine Aufgabe dar, die in der Exchange-Datenbank erstellt werden soll.
ContactItemType	Stellt ein Kontaktelement dar, das in der Exchange-Datenbank erstellt werden soll.
CalendarItemType	Stellt einen Kalendereintrag dar, der in der Exchange-Datenbank erstellt werden soll.
AcceptItemType	Stellt ein Antwortobjekt zum Annehmen von Besprechungseinladungen dar.
CancelCalendarItemType	Stellt ein Antwortobjekt zum Abbrechen eines Kalenderelements dar.
DeclineItemType	Stellt ein Antwortobjekt für ablehnende Besprechungseinladungen dar.
ForwardItemType	Stellt ein Antwortobjekt zum Weiterleiten eines Elements an andere Benutzer dar.
RemoveItemType	Stellt ein Antwortobjekt zum Entfernen einer abgebrochenen Besprechung aus einem Kalender dar.
ReplyAllToItemType	Stellt ein Antwortobjekt zum Antworten an alle Empfänger eines Elements dar.
ReplyToItemType	Stellt ein Antwortobjekt zum Antworten an den Absender eines Elements dar.
TentativelyAcceptItemType	Stellt ein Antwortobjekt zum vorläufigen Annehmen einer Besprechungseinladung dar.
SuppressReadReceiptType	Stellt ein Antwortobjekt dar, das verwendet wird, um Lesebestätigungen zu unterdrücken.

Hinweis: CreateItemType Kann nicht zum Erstellen von Verteilerlisten, Besprechungsnachrichten, Besprechungsanfragen, Besprechungsantwortnachrichten und Besprechungsabbruchnachrichten verwendet werden.

Konstruktoren

CreateItemType()

Der CreateItemType Konstruktor initialisiert eine neue Instanz der CreateItemType -Klasse.

Eigenschaften

Items	Die Items -Eigenschaft ruft die Auflistung der zu erstellenden Elemente ab oder legt sie fest.
MessageDisposition	Die MessageDisposition -Eigenschaft ruft eine Enumeration ab, die beschreibt, wie ein Element nach der Erstellung behandelt wird, oder legt diese fest. Diese Eigenschaft ist für E-Mail-Nachrichten erforderlich.
MessageDispositionSpecified	Die MessageDispositionSpecified -Eigenschaft ruft einen booleschen Wert ab, der angibt, ob die MessageDisposition Eigenschaft in die SOAP-Anforderung (Simple Object Access Protocol) serialisiert wird, oder legt diesen fest.
SavedItemFolderId	Die SavedItemFolderId -Eigenschaft ruft den Ordner ab, in dem neue Elemente gespeichert werden, oder legt diese fest.
SendMeetingInvitations	Die SendMeetingInvitations -Eigenschaft ruft eine Enumeration ab, die beschreibt, wie Besprechungsanfragen nach ihrer Erstellung behandelt werden, oder legt diese fest. Diese Eigenschaft ist für Kalenderelemente erforderlich.
SendMeetingInvitationsSpecified	Die SendMeetingInvitationsSpecified -Eigenschaft ruft einen booleschen Wert ab, der angibt, ob in SendMeetingInvitations die SOAP-Anforderung (Simple Object Access Protocol) serialisiert wird, oder legt diesen fest.

Gilt für:

Freigeben über