ConvertIdType クラス

定義

名前空間:

ExchangeWebServices

アセンブリ:

EWS.dll

クラスは ConvertIdType 、サポートされている Exchange 形式間でアイテム識別子とフォルダー識別子を変換する要求を表します。

public ref class ConvertIdType : ExchangeWebServices::BaseRequestType

public class ConvertIdType : ExchangeWebServices.BaseRequestType

Public Class ConvertIdType
Inherits BaseRequestType

継承

Object

BaseRequestType

ConvertIdType

例

次の例では、Exchange Web Services 識別子形式と Outlook Web Access 識別子形式の間で識別子の変換を実行します。

static void ConvertId()
{
    // Set the version, credentials, and the Client Access server on ExchangeServiceBinding.
    ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.RequestServerVersionValue = new RequestServerVersion();
    esb.RequestServerVersionValue.Version = ExchangeVersionType.Exchange2007_SP1;
    esb.Credentials = new NetworkCredential("username", "password", "domain");
    esb.Url = "https://FQDN/ews/exchange.asmx";

    // Create the request.
    ConvertIdType request = new ConvertIdType();
    request.SourceIds = new AlternateIdType[1];
    request.SourceIds[0] = new AlternateIdType();

    // Convert from the Exchange Web Services identifier to an Outlook Web Access identifier.
    request.SourceIds[0].Format = IdFormatType.EwsId;
    (request.SourceIds[0] as AlternateIdType).Id = "AAMkADk";
    (request.SourceIds[0] as AlternateIdType).Mailbox = "user@example.com";
    request.DestinationFormat = IdFormatType.OwaId;

    try
    {
        // Send the ConvertIdType request and get the response.
        ConvertIdResponseType response = esb.ConvertId(request);
        ArrayOfResponseMessagesType aormt = response.ResponseMessages;
        ResponseMessageType[] rmta = aormt.Items;

        // Check each response message.
        foreach (ConvertIdResponseMessageType resp in rmta)
        {
            if (resp.ResponseClass == ResponseClassType.Success)
            {
                ConvertIdResponseMessageType cirmt = (resp as ConvertIdResponseMessageType);
                AlternateIdType myId = (cirmt.AlternateId as AlternateIdType);

                string format = myId.Format.ToString();
                string identifier = myId.Id;
                string mailbox = myId.Mailbox;

                Console.WriteLine("Converted to format: {0}\r\nIdentifier: {1}\r\nMailbox: {2}", format, identifier, mailbox);
            }
            else if (resp.ResponseClass == ResponseClassType.Error)
            {
                Console.WriteLine("Error: " + resp.MessageText);
            }
            else
                Console.WriteLine("Warning: " + resp.MessageText);
        }
        Console.ReadLine();
    }
    catch (Exception e)
    {
        Console.WriteLine(e.Message);
        Console.ReadLine();
    }
}

コンストラクター

ConvertIdType()

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

プロパティ

DestinationFormat	プロパティは DestinationFormat 、変換されたすべての識別子に対して返される識別子の形式を取得または設定します。
SourceIds	プロパティは SourceIds 、変換するソース識別子を含む AlternativeIdBaseType 配列を取得または設定します。