CreateFolderType Clase

Definición

Espacio de nombres:

ExchangeWebServices

Ensamblado:

EWS.dll

La CreateFolderType clase representa una solicitud para crear una carpeta.

public ref class CreateFolderType : ExchangeWebServices::BaseRequestType

public class CreateFolderType : ExchangeWebServices.BaseRequestType

Public Class CreateFolderType
Inherits BaseRequestType

Herencia

Object

BaseRequestType

CreateFolderType

Ejemplos

En el ejemplo siguiente se muestra cómo crear un conjunto de carpetas en la Bandeja de entrada. En el ejemplo se crea una carpeta normal, una carpeta de contactos y una carpeta de tareas.

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

Comentarios

La CreateFolderType clase se usa para crear carpetas de tareas, carpetas de búsqueda, carpetas de contactos, carpetas de calendario y carpetas normales. Las nuevas carpetas se pueden ampliar mediante la ExtendedProperty propiedad .

Nota: La clase CreateFolderType no agrega carpetas administradas a un buzón. Para obtener información sobre cómo agregar carpetas administradas a un buzón de correo, vea CreateManagedFolderRequestType, Operación CreateManagedFolder y Agregar carpetas administradas. Para obtener un ejemplo que muestra cómo implementar carpetas administradas, consulte Ejemplo de selector de carpetas administradas.

Constructores

CreateFolderType()

El CreateFolderType constructor inicializa una nueva instancia de la CreateFolderType clase .

Propiedades

Folders	La Folders propiedad obtiene o establece un conjunto de carpetas para crear en una base de datos de Exchange. Esta propiedad obtiene o establece un conjunto de FolderTypeobjetos , CalendarFolderType, ContactsFolderType, SearchFolderTypeo TasksFolderType . La propiedad es obligatoria. Se trata de una propiedad de lectura y escritura.
ParentFolderId	La ParentFolderId propiedad obtiene o establece el identificador de la carpeta que contendrá las carpetas recién creadas. Esta propiedad obtiene o establece un TargetFolderIdTypeobjeto , que puede ser un FolderIdType objeto o DistinguishedFolderIdType . La propiedad es obligatoria. Se trata de una propiedad de lectura y escritura.