CreateFolderType Classe

Referência

Definição

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

O 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 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

O CreateFolderType classe é usado para criar pastas de tarefas, pastas de pesquisa, as pastas de contatos, pastas de calendário e pastas comuns. Novas pastas podem ser estendidas usando o ExtendedProperty propriedade.

Observação: CreateFolderType a classe não adiciona pastas gerenciadas para uma caixa de correio. Para obter informações sobre como adicionar pastas gerenciadas para uma caixa de correio, consulte CreateManagedFolderRequestType, CreateManagedFolder operação e adicionando pastas gerenciadas. Para obter um exemplo que mostra como implementar as pastas gerenciadas, consulte Sample de seletor de pasta gerenciada

Construtores

CreateFolderType()

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

Propriedades

Folders	O Folders propriedade obtém ou define um conjunto de pastas para criar um banco de dados do Exchange. Essa propriedade obtém ou define um conjunto de FolderType, CalendarFolderType, ContactsFolderType, SearchFolderType, ou TasksFolderType objetos. Essa propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.
ParentFolderId	O ParentFolderId propriedade obtém ou define o identificador da pasta que conterá as pastas recém-criado. Essa propriedade obtém ou define um TargetFolderIdType, que pode ser um FolderIdType ou DistinguishedFolderIdType objeto. Essa propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.

Aplica-se a