GetFolderType Klasse

Definition

Namespace:

ExchangeWebServices

Assembly:

EWS.dll

Die GetFolderType -Klasse stellt eine Anforderung zum Abrufen von Ordnern aus einem Postfach dar.

public ref class GetFolderType : ExchangeWebServices::BaseRequestType

public class GetFolderType : ExchangeWebServices.BaseRequestType

Public Class GetFolderType
Inherits BaseRequestType

Vererbung

Object

BaseRequestType

GetFolderType

Beispiele

Das folgende Beispiel zeigt, wie Sie zwei Ordner abrufen. Einer der Ordner wird durch die FolderId-Eigenschaft identifiziert, und der andere Ordner wird durch die DistinguishedFolderId-Eigenschaft identifiziert. Die Antwort enthält die Eigenschaften, die für das AllProperties-Antwort-Shape definiert sind, und die zusätzlichen Informationen, die von der ManagedFolderInformation-Eigenschaft bereitgestellt werden, wenn sie für den Ordner gilt.

static void GetFolder(ExchangeServiceBinding esb)
{ 
    // Identify the folders to get.
    FolderIdType folder1 = new FolderIdType();
    DistinguishedFolderIdType sentitems = new DistinguishedFolderIdType();
    folder1.Id = "AQAlAE1BQG";
    sentitems.Id = DistinguishedFolderIdNameType.sentitems;

    // Identify the folder properties to return.
    FolderResponseShapeType properties = new FolderResponseShapeType();
    PathToUnindexedFieldType ptuft = new PathToUnindexedFieldType();
    ptuft.FieldURI = UnindexedFieldURIType.folderManagedFolderInformation;
    PathToUnindexedFieldType[] ptufts = new PathToUnindexedFieldType[1] { ptuft };
    properties.AdditionalProperties = ptufts; 
    properties.BaseShape = DefaultShapeNamesType.AllProperties;

    // Form the get folder request.
    GetFolderType <span class="label">request</span> = new GetFolderType();
<span class="label">request</span>.FolderIds = new BaseFolderIdType[2] { folder1, sentitems };
<span class="label">request</span>.FolderShape = properties;

    try
    {
        // Send the request and get the response.
        GetFolderResponseType response = esb.GetFolder(<span class="label">request</span>);
        ArrayOfResponseMessagesType aormt = response.ResponseMessages;
        ResponseMessageType[] rmta = aormt.Items;

        foreach (ResponseMessageType rmt in rmta)
        {
            if (rmt.ResponseClass == ResponseClassType.Success)
            {
                FolderInfoResponseMessageType firmt;
                firmt = (rmt as FolderInfoResponseMessageType);
                BaseFolderType[] folders = firmt.Folders;

                foreach (BaseFolderType folder in folders)
                {
                    if (folder is CalendarFolderType)
                    {
                        CalendarFolderType calendar;
                        calendar = (folder as CalendarFolderType);
                    }
                    else if (folder is ContactsFolderType)
                    {
                        // Handle the contacts folder.
                    }
                    else
                    { 
                        // Handle SearchFolderType, TasksFolderType,
                        // and FolderType.
                    }
                }
            }
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(e.Message);
    }
}

Hinweise

Der GetFolder-Vorgang wird verwendet, um reguläre, verwaltete und Standardordner aus einem Exchange-Postfach abzurufen.

Konstruktoren

GetFolderType()

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

Eigenschaften

FolderIds	Die FolderIds -Eigenschaft ruft die Bezeichner der abzurufenden Ordner ab oder legt diese fest.
FolderShape	Die FolderShape -Eigenschaft ruft die Eigenschaften ab, die in der Antwort zurückgegeben werden sollen, oder legt diese fest.