CreateItemType クラス

定義

名前空間:

ExchangeWebServices

アセンブリ:

EWS.dll

クラスは CreateItemType 、項目または応答オブジェクトを作成する要求を表します。

public ref class CreateItemType : ExchangeWebServices::BaseRequestType

public class CreateItemType : ExchangeWebServices.BaseRequestType

Public Class CreateItemType
Inherits BaseRequestType

継承

Object

BaseRequestType

CreateItemType

例

次のコード例は、1 つの電子メールを作成し、複数の受信者に送信し、そのコピーを送信済みアイテムの既定のフォルダーに保存する CreateItem 要求を示しています。

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);
    }
}

注釈

CreateItemTypeは、Exchange データベースに応答オブジェクトとアイテムを作成するために使用されます。 次の表では、 を使用 CreateItemTypeして作成できる項目と応答オブジェクトについて説明します。

ItemType	Exchange データベースに作成する汎用アイテムを表します。
MessageType	Exchange データベースに作成する電子メール メッセージを表します。
TaskType	Exchange データベースに作成するタスクを表します。
ContactItemType	Exchange データベースに作成する連絡先アイテムを表します。
CalendarItemType	Exchange データベースに作成する予定表エントリを表します。
AcceptItemType	会議出席依頼を受け入れるための応答オブジェクトを表します。
CancelCalendarItemType	予定表アイテムを取り消す応答オブジェクトを表します。
DeclineItemType	会議出席依頼を辞退するための応答オブジェクトを表します。
ForwardItemType	項目を他のユーザーに転送するための応答オブジェクトを表します。
RemoveItemType	キャンセルされた会議を予定表から削除するための応答オブジェクトを表します。
ReplyAllToItemType	アイテムのすべての受信者に返信するための応答オブジェクトを表します。
ReplyToItemType	アイテムの送信者に返信するための応答オブジェクトを表します。
TentativelyAcceptItemType	会議出席依頼を仮承諾するための応答オブジェクトを表します。
SuppressReadReceiptType	開封確認を抑制するために使用される応答オブジェクトを表します。

注: CreateItemType 配布リスト、会議メッセージ、会議出席依頼メッセージ、会議応答メッセージ、会議のキャンセル メッセージを作成するために使用することはできません。

コンストラクター

CreateItemType()

コンストラクターは CreateItemType 、 クラスの新しいインスタンスを CreateItemType 初期化します。

プロパティ

Items	プロパティは Items 、作成する項目のコレクションを取得または設定します。
MessageDisposition	プロパティは MessageDisposition 、アイテムの作成後の処理方法を説明する列挙体を取得または設定します。 このプロパティは、電子メール メッセージに必要です。
MessageDispositionSpecified	プロパティは MessageDispositionSpecified 、プロパティを Simple Object Access Protocol (SOAP) 要求にシリアル化するかどうかを MessageDisposition 指定するブール値を取得または設定します。
SavedItemFolderId	プロパティは SavedItemFolderId 、新しい項目を保存するフォルダーを取得または設定します。
SendMeetingInvitations	プロパティは SendMeetingInvitations 、会議出席依頼の作成後の処理方法を説明する列挙体を取得または設定します。 予定表アイテムには、このプロパティが必要です。
SendMeetingInvitationsSpecified	プロパティは SendMeetingInvitationsSpecified 、 を Simple Object Access Protocol (SOAP) 要求にシリアル化するかどうかを SendMeetingInvitations 指定するブール値を取得または設定します。