CopyItemType Class

Definition

The CopyItemType class represents an operation to copy items in a mailbox.

public ref class CopyItemType : ExchangeWebServices::BaseMoveCopyItemType
public class CopyItemType : ExchangeWebServices.BaseMoveCopyItemType
Public Class CopyItemType
Inherits BaseMoveCopyItemType
Inheritance

Examples

The following code example copies two items to the Inbox.

static void CopyItem(ExchangeServiceBinding esb)
{ 
    // Identify the items to copy.
    ItemIdType item1 = new ItemIdType();
    ItemIdType item2 = new ItemIdType();
    item1.Id = "AAAlAE1BQ1";
    item2.Id = "AAAlAE1BQ2";
    ItemIdType[] items = new ItemIdType[2] { item1, item2 };

    // Identify the destination folder.
    DistinguishedFolderIdType destFolder = new DistinguishedFolderIdType();
    destFolder.Id = DistinguishedFolderIdNameType.inbox;

    // Form the copy item request.
    CopyItemType <span class="label">request</span> = new CopyItemType();
<span class="label">request</span>.ItemIds = items;
<span class="label">request</span>.ToFolderId = new TargetFolderIdType();
<span class="label">request</span>.ToFolderId.Item = destFolder;

    try
    {
        // Send the request and get the response.
        CopyItemResponseType response = esb.CopyItem(<span class="label">request</span>);
        ArrayOfResponseMessagesType aormt = response.ResponseMessages;
        ResponseMessageType[] rmta = aormt.Items;

        foreach (ResponseMessageType rmt in rmta)
        {
            if (rmt.ResponseClass == ResponseClassType.Success)
            {
                Console.WriteLine("Successful item copy!");
            }
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(e.Message);
    }
}

Remarks

The item identifier of the new item is returned in the response message (CopyItemResponseType). Item identifiers are not returned in responses for a cross-mailbox or mailbox to public folder CopyItem operation.

Constructors

CopyItemType()

The CopyItemType constructor initializes a new instance of the CopyItemType class.

Properties

ItemIds

The ItemIds property gets or sets an array of elements of type BaseItemIdType that specifies a set of items to move or copy.

(Inherited from BaseMoveCopyItemType)
ReturnNewItemIds (Inherited from BaseMoveCopyItemType)
ReturnNewItemIdsSpecified (Inherited from BaseMoveCopyItemType)
ToFolderId

The ToFolderId property gets or sets an instance of the TargetFolderIdType class that specifies the folder to which to move or copy the items specified by the ItemIds property.

(Inherited from BaseMoveCopyItemType)

Applies to