UpdateFolderType Classe

Referência

Definição

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

O UpdateFolderType classe representa uma solicitação de atualização de 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 tem sido reduzidas 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 você está atualizando uma pasta.

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

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

ErrorInvalidPropertySet	foi feita uma tentativa para definir um valor para uma propriedade que é 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 para modificar.

Construtores

UpdateFolderType()

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

Propriedades

FolderChanges

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

Aplica-se a