UpdateFolderType Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
ErrorInvalidPropertySet | Se intentó establecer un valor para una propiedad de solo lectura. |
ErrorChangeKeyRequiredForWriteOperations | No se proporcionó una clave de cambio para la operación de actualización. |
ErrorIncorrectUpdatePropertyCount | Se 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. |