UpdateFolderType Classe

Definição

Namespace:

ExchangeWebServices

Assembly:

EWS.dll

A UpdateFolderType classe representa uma solicitação para atualizar pastas em uma caixa de correio.

public ref class UpdateFolderType : ExchangeWebServices::BaseRequestType

public class UpdateFolderType : ExchangeWebServices.BaseRequestType

Public Class UpdateFolderType
Inherits BaseRequestType

Herança

Object

BaseRequestType

UpdateFolderType

Exemplos

O exemplo de código a seguir mostra como atualizar o nome de exibição de uma pasta. O identificador de pasta e a chave de alteração foram encurtados para preservar a legibilidade.

static void UpdateFolder(ExchangeServiceBinding esb)
{
    // Create the container for the set of updates to be made to the folders.
    FolderChangeType changes = new FolderChangeType();

    // Identify the folder to change.
    FolderIdType folderId = new FolderIdType();
    folderId.Id = "AQAlAE1BQG1h=";
    folderId.ChangeKey = "AQAAABYA";
    changes.Item = folderId;

    // Create the update. Identify the field to update and the value to set for it.
    SetFolderFieldType uDisplayName = new SetFolderFieldType();
    PathToUnindexedFieldType displayNameProp = new PathToUnindexedFieldType();
    displayNameProp.FieldURI = UnindexedFieldURIType.folderDisplayName;
    FolderType updatedFolder = new FolderType();
    updatedFolder.DisplayName = "My new folder name";
    uDisplayName.Item = displayNameProp; 
    uDisplayName.Item1 = updatedFolder;

    // Add the folder to change.
    changes.Item = folderId;

    // Add the array of changes; in this case, a single element array.
    changes.Updates = new FolderChangeDescriptionType[1] { uDisplayName };

    // Add changes to the request.
    UpdateFolderType <span class="label">request</span> = new <span class="label">UpdateFolderType</span>();
<span class="label">request</span>.FolderChanges = new FolderChangeType[1] { changes };

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

    // Get the new change key for the updated folder.
    foreach (ResponseMessageType rmt in rmta)
    {
        FolderInfoResponseMessageType firmt = (rmt as FolderInfoResponseMessageType);

        foreach (BaseFolderType folder in firmt.Folders)
        {
            Console.WriteLine("New change key: " + folder.FolderId.ChangeKey);
        }
    }
}

Comentários

Você pode acrescentar, definir ou excluir propriedades quando estiver atualizando uma pasta.

A tabela a seguir lista os códigos de resposta de erro que podem ser retornados para uma operação UpdateFolder.

Códigos de resposta de erro da operação UpdateFolder

ErrorInvalidPropertySet	Foi feita uma tentativa de definir um valor para uma propriedade somente leitura.
ErrorChangeKeyRequiredForWriteOperations	Uma chave de alteração não foi fornecida para a operação de atualização.
ErrorIncorrectUpdatePropertyCount	Foi feita uma tentativa de enviar uma descrição de alteração que inclui mais de uma propriedade a ser modificada.

Construtores

UpdateFolderType()

O UpdateFolderType construtor inicializa uma nova instância da UpdateFolderType classe.

Propriedades

FolderChanges

A FolderChanges propriedade obtém ou define uma matriz de alterações feitas em um conjunto de pastas. Esta propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.