CreateFolderType Classe

Definição

Namespace:

ExchangeWebServices

Assembly:

EWS.dll

A CreateFolderType classe representa uma solicitação para criar uma pasta.

public ref class CreateFolderType : ExchangeWebServices::BaseRequestType

public class CreateFolderType : ExchangeWebServices.BaseRequestType

Public Class CreateFolderType
Inherits BaseRequestType

Herança

Object

BaseRequestType

CreateFolderType

Exemplos

O exemplo a seguir mostra como criar um conjunto de pastas na caixa de entrada. O exemplo cria uma pasta regular, uma pasta de contatos e uma pasta de tarefas.

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

Comentários

A CreateFolderType classe é usada para criar pastas de tarefas, pastas de pesquisa, pastas de contatos, pastas de calendário e pastas regulares. Novas pastas podem ser estendidas usando a ExtendedProperty propriedade.

Observação: a classe CreateFolderType não adiciona pastas gerenciadas a uma caixa de correio. Para obter informações sobre como adicionar pastas gerenciadas a uma caixa de correio, consulte CreateManagedFolderRequestType, Operação CreateManagedFolder e Adição de Pastas Gerenciadas. Para obter um exemplo que mostra como implementar pastas gerenciadas, consulte Exemplo de Seletor de Pasta Gerenciada

Construtores

CreateFolderType()

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

Propriedades

Folders	A Folders propriedade obtém ou define um conjunto de pastas a serem criadas em um banco de dados do Exchange. Essa propriedade obtém ou define um conjunto de FolderTypeobjetos , CalendarFolderType, ContactsFolderType, SearchFolderTypeou TasksFolderType . Esta propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.
ParentFolderId	A ParentFolderId propriedade obtém ou define o identificador da pasta que conterá as pastas recém-criadas. Essa propriedade obtém ou define um TargetFolderIdType, que pode ser um FolderIdType objeto ou DistinguishedFolderIdType . Esta propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.