Compartir a través de


UpdateFolderType Clase

Definición

La UpdateFolderType clase representa una solicitud para actualizar carpetas en un buzón de correo.

public ref class UpdateFolderType : ExchangeWebServices::BaseRequestType
public class UpdateFolderType : ExchangeWebServices.BaseRequestType
Public Class UpdateFolderType
Inherits BaseRequestType
Herencia
UpdateFolderType

Ejemplos

En el ejemplo de código siguiente se muestra cómo actualizar el nombre para mostrar de una carpeta. El identificador de carpeta y la clave de cambio se han acortado para conservar la legibilidad.

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

Comentarios

Puede anexar, establecer o eliminar propiedades al actualizar una carpeta.

En la tabla siguiente se enumeran los códigos de respuesta de error que se pueden devolver para una operación UpdateFolder.

Códigos de respuesta de error de la operación UpdateFolder

ErrorInvalidPropertySetSe intentó establecer un valor para una propiedad de solo lectura.
ErrorChangeKeyRequiredForWriteOperationsNo se proporcionó una clave de cambio para la operación de actualización.
ErrorIncorrectUpdatePropertyCountSe intentó enviar una descripción de cambio que incluye más de una propiedad para modificar.

Constructores

UpdateFolderType()

El UpdateFolderType constructor inicializa una nueva instancia de la UpdateFolderType clase .

Propiedades

FolderChanges

La FolderChanges propiedad obtiene o establece una matriz de cambios que se realizan en un conjunto de carpetas. La propiedad es obligatoria. Se trata de una propiedad de lectura y escritura.

Se aplica a