GetFolderType Classe

Definição

Namespace:

ExchangeWebServices

Assembly:

EWS.dll

A GetFolderType classe representa uma solicitação para obter pastas de uma caixa de correio.

public ref class GetFolderType : ExchangeWebServices::BaseRequestType

public class GetFolderType : ExchangeWebServices.BaseRequestType

Public Class GetFolderType
Inherits BaseRequestType

Herança

Object

BaseRequestType

GetFolderType

Exemplos

O exemplo a seguir mostra como obter duas pastas. Uma das pastas é identificada pela propriedade FolderId e a outra pasta é identificada pela propriedade DistinguishedFolderId. A resposta conterá as propriedades definidas para a forma de resposta AllProperties e as informações adicionais fornecidas pela propriedade ManagedFolderInformation se ela se aplicar à pasta.

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

Comentários

A operação GetFolder é usada para obter pastas regulares, gerenciadas e padrão de uma caixa de correio do Exchange.

Construtores

GetFolderType()

O GetFolderType construtor inicializa uma nova instância da GetFolderType classe.

Propriedades

FolderIds	A FolderIds propriedade obtém ou define os identificadores das pastas a serem obtidos.
FolderShape	A FolderShape propriedade obtém ou define as propriedades a serem retornadas na resposta.