UpdateFolderType Klasse

Referenz

Definition

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Die UpdateFolderType -Klasse stellt eine Anforderung zum Aktualisieren von Ordnern in einem Postfach dar.

public ref class UpdateFolderType : ExchangeWebServices::BaseRequestType

public class UpdateFolderType : ExchangeWebServices.BaseRequestType

Public Class UpdateFolderType
Inherits BaseRequestType

Vererbung: Object

BaseRequestType
UpdateFolderType

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie den Anzeigenamen eines Ordners aktualisieren. Der Ordnerbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

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

Hinweise

Sie können Eigenschaften anfügen, festlegen oder löschen, wenn Sie einen Ordner aktualisieren.

In der folgenden Tabelle sind die Fehlerantwortcodes aufgeführt, die für einen UpdateFolder-Vorgang zurückgegeben werden können.

Fehlerantwortcodes des UpdateFolder-Vorgangs

ErrorInvalidPropertySet	Es wurde versucht, einen Wert für eine schreibgeschützte Eigenschaft festzulegen.
ErrorChangeKeyRequiredForWriteOperations	Für den Aktualisierungsvorgang wurde kein Änderungsschlüssel bereitgestellt.
ErrorIncorrectUpdatePropertyCount	Es wurde versucht, eine Änderungsbeschreibung zu übermitteln, die mehrere zu ändernde Eigenschaften enthält.

Konstruktoren

UpdateFolderType()

Der UpdateFolderType Konstruktor initialisiert eine neue Instanz der UpdateFolderType -Klasse.

Eigenschaften

FolderChanges

Die FolderChanges -Eigenschaft ruft ein Array von Änderungen ab, die an einer Gruppe von Ordnern vorgenommen werden, oder legt dieses fest. Diese Eigenschaft ist erforderlich. Dies ist eine Lese-/Schreibeigenschaft.

Gilt für:

Freigeben über