CreateFolderType 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 CreateFolderType -Klasse stellt eine Anforderung zum Erstellen eines Ordners dar.

public ref class CreateFolderType : ExchangeWebServices::BaseRequestType

public class CreateFolderType : ExchangeWebServices.BaseRequestType

Public Class CreateFolderType
Inherits BaseRequestType

Vererbung: Object

BaseRequestType
CreateFolderType

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine Gruppe von Ordnern im Posteingang erstellen. Im Beispiel werden ein regulärer Ordner, ein Kontaktordner und ein Aufgabenordner erstellt.

static void CreateFolder(ExchangeServiceBinding esb)
{
    // Identify the folders to create.
    FolderType folder1 = new FolderType();
    ContactsFolderType folder2 = new ContactsFolderType();
    TasksFolderType folder3 = new TasksFolderType();
    folder1.DisplayName = "MyNewRegularFolder";
    folder2.DisplayName = "MyNewContactsFolder";
    folder3.DisplayName = "MyNewTasksFolder";

    // Identify where the new folders are created.
    DistinguishedFolderIdType distFolder = new DistinguishedFolderIdType();
    distFolder.Id = DistinguishedFolderIdNameType.inbox;
    TargetFolderIdType targetID = new TargetFolderIdType();
    targetID.Item = distFolder;

    // Create the request.
    CreateFolderType <span class="label">createFolder</span> = new CreateFolderType();
<span class="label">createFolder</span>.Folders = new BaseFolderType[] { folder1, folder2, folder3 };
<span class="label">createFolder</span>.ParentFolderId = targetID;

    try
    {
        // Send the request and get the response.
        CreateFolderResponseType response = esb.CreateFolder(<span class="label">createFolder</span>);

        // Get the response messages.
        ResponseMessageType[] rmta = response.ResponseMessages.Items;

        foreach (ResponseMessageType responseMessage in rmta)
        {
            // Perform error checks in production code.
            FolderInfoResponseMessageType firmt = (responseMessage as FolderInfoResponseMessageType);
            BaseFolderType[] folders = firmt.Folders;

            foreach (BaseFolderType folder in folders)
            {
                if (folder is TasksFolderType)
                {
                    TasksFolderType tft = (folder as TasksFolderType);
                    //TODO: Handle the task folder.
                }

                else if (folder is CalendarFolderType)
                {
                    CalendarFolderType cft = (folder as CalendarFolderType);
                    // TODO: Handle the calendar folder.
                }

                else
                {
                    //TODO: Handle the SearchFolderType, ContactsFolderType, and FolderType folders.
                }
            }
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(e.Message);
    }
}

Hinweise

Die CreateFolderType -Klasse wird zum Erstellen von Aufgabenordnern, Suchordnern, Kontaktordnern, Kalenderordnern und regulären Ordnern verwendet. Neue Ordner können mithilfe der ExtendedProperty -Eigenschaft erweitert werden.

Hinweis: Die CreateFolderType-Klasse fügt keine verwalteten Ordner zu einem Postfach hinzu. Informationen zum Hinzufügen verwalteter Ordner zu einem Postfach finden Sie unter CreateManagedFolderRequestType, CreateManagedFolder-Vorgang und Hinzufügen verwalteter Ordner. Ein Beispiel, das zeigt, wie Verwaltete Ordner implementiert werden, finden Sie unter Beispiel für die Auswahl verwalteter Ordner.

Konstruktoren

CreateFolderType()

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

Eigenschaften

Folders	Die Folders -Eigenschaft ruft einen Satz von Ordnern ab, die in einer Exchange-Datenbank erstellt werden sollen, oder legt diesen fest. Diese Eigenschaft ruft einen Satz von FolderType- , - CalendarFolderType, ContactsFolderType- SearchFolderTypeoder TasksFolderType -Objekten ab oder legt diese fest. Diese Eigenschaft ist erforderlich. Dies ist eine Lese-/Schreibeigenschaft.
ParentFolderId	Die ParentFolderId -Eigenschaft ruft den Bezeichner des Ordners ab, der die neu erstellten Ordner enthält, oder legt diesen fest. Diese Eigenschaft ruft einen TargetFolderIdTypeab oder legt einen fest, bei dem es sich um ein - oder DistinguishedFolderIdType -FolderIdTypeObjekt handeln kann. Diese Eigenschaft ist erforderlich. Dies ist eine Lese-/Schreibeigenschaft.

Gilt für:

Freigeben über