Communiquer avec EWS à l’aide de l’API managée EWSCommunicate with EWS by using the EWS Managed API

Trouvez des informations sur l’utilisation de l’API managée EWS pour communiquer avec EWS dans Exchange.Find information about how to use the EWS Managed API to communicate with EWS in Exchange.

La classe ExchangeService dans l’API managée EWS contient les méthodes et propriétés que vous utilisez pour définir les informations d’identification utilisateur, identifier le point de terminaison EWS, envoyer et recevoir des messages SOAP et configurer la liaison de communiquer avec EWS.The ExchangeService class in the EWS Managed API contains the methods and properties that you use to set user credentials, identify the EWS endpoint, send and receive SOAP messages, and configure the binding to communicate with EWS. Avant de pouvoir utiliser l’API managée EWS pour accomplir une tâche, vous devez créer une instance de la classe ExchangeService et le lier à EWS.Before you can use the EWS Managed API to perform any task, you have to create an instance of the ExchangeService class and bind it to EWS.

Après avoir configuré un objet ExchangeService avec les informations d’identification utilisateur et le point de terminaison EWS, n’importe quel objet boîte aux lettres qui fait référence à l’objet ExchangeService peut utiliser les types suivants de la méthode pour communiquer avec EWS :After you set up an ExchangeService object with user credentials and the EWS endpoint, any mailbox object that references the ExchangeService object can use the following method types to communicate with EWS:

  • Méthodes de l’objet ExchangeService — toutes les méthodes de l’objet ExchangeService qui ne sont pas héritées le type d’objet base appeler EWS.ExchangeService object methods — All the methods on the ExchangeService object that are not inherited from the base Object type make calls to EWS.

  • Élément de boîte aux lettres Exchange et dossier type de méthodes.Exchange mailbox item and folder type methods.

Le tableau 1. Élément de boîte aux lettres et de dossiers tapez méthodes qui communiquent avec EWSTable 1. Mailbox item and folder type methods that communicate with EWS

MéthodeMethod FonctionWhat it does Opérations qu’elle appelleOperations that it calls
LoadLoad
Obtient les propriétés sur un objet de configuration utilisateur, pièces jointes ou élément.Gets properties on an item, attachment, or user configuration object.
GetItem OperationGetItem operation

Opération GetAttachmentGetAttachment operation

Opération GetUserConfigurationGetUserConfiguration operation
Créer une liaisonBind
Remplit un nouvel élément sur le client avec des informations à partir d’un élément existant sur le serveur.Populates a new item on the client with information from an existing item on the server.
GetItem OperationGetItem operation
SaveSave
Enregistre la copie de l’élément client sur le serveur.Saves the copy of the client item on the server.
UpdateItem OperationUpdateItem operation

Opération UpdateFolderUpdateFolder operation

CreateItem OperationCreateItem operation

Opération CreateFolderCreateFolder operation
Mettre à jourUpdate
Met à jour le serveur avec les modifications effectuées sur le client.Updates the server with the changes made on the client.

Pour les éléments et les dossiers, la méthode de mise à jour utilise l' opération UpdateItem et l' opération UpdateFolder.For items and folders, the Update method uses the UpdateItem operation and the UpdateFolder operation.
UpdateItem OperationUpdateItem operation

Opération UpdateFolderUpdateFolder operation
SupprimerDelete
Supprime un élément sur le serveur.Deletes an item on the server.

Pour les éléments et les dossiers, la méthode Delete utilise l' opération DeleteFolder.For items and folders, the Delete method uses the and the DeleteFolder operation.
Opération DeleteItemDeleteItem operation

Opération DeleteFolderDeleteFolder operation
CopierCopy
Crée une copie de l’élément ou les dossiers sur le serveur.Creates a copy of the item or folders on the server.
Opération CopyItemCopyItem operation

Opération CopyFolderCopyFolder operation
DéplacerMove
Déplace les éléments ou des dossiers sur le serveur.Moves items or folders on the server.
Opération MoveItemMoveItem operation

Opération MoveFolderMoveFolder operation

Pour utiliser l’API managée EWS pour communiquer avec EWSTo use the EWS Managed API to communicate with EWS

  1. Instanciez la classe ExchangeService .Instantiate the ExchangeService class.

     ExchangeService service = new ExchangeService();
    

    Notes

    L’instanciation de ExchangeService avec un constructeur vide créera une instance qui est liée à la dernière version connue d’Exchange.Instantiating ExchangeService with an empty constructor will create an instance that is bound to the latest known version of Exchange. Vous pouvez également cibler une version spécifique d’Exchange en spécifiant la version en tant que paramètre.Alternatively, you can target a specific version of Exchange by specifying version as a parameter. ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2007_SP1);

  2. Définir les informations d’identification de l’utilisateur qui envoie des requêtes sur le serveur Exchange.Set the credentials of the user who sends requests to the Exchange server. Si vous souhaitez vous connecter à EWS depuis un ordinateur qui est connecté au domaine, les informations d’identification de l’utilisateur authentifié, définissez la propriété UseDefaultCredentials sur l’objet ExchangeService sur true.If you want to connect to EWS from a computer that is logged on to the domain, using the credentials of the authenticated user, set the UseDefaultCredentials property on the ExchangeService object to true.

     // Connect by using the default credentials of the authenticated user.
     service.UseDefaultCredentials = true;
    

    Si vous ne souhaitez pas vous connecter en utilisant les informations d’identification des utilisateurs par défaut, définissez la propriété d’informations d’identification sur l’objet ExchangeService spécifier de manière explicite les informations d’identification d’un autre utilisateur.If you do not want to connect by using the default user credentials, set the Credentials property on the ExchangeService object to explicitly specify the credentials of a different user. Si vous utilisez Exchange Online ou Exchange Online dans le cadre d’Office 365, vous allez utiliser l’authentification de base, avec uniquement un nom d’utilisateur et un mot de passe.If you are using Exchange Online or Exchange Online as part of Office 365, you'll use basic authentication, with just a user name and password. Un nom de domaine est requis pour l’authentification NTLM.A domain name is required for NTLM authentication.

     // Connect by using the credentials of user1 at contoso.com.
     service.Credentials = new WebCredentials("user1@contoso.com", "password");
    

    Vous pouvez également spécifier les informations d’identification de l’utilisateur à l’aide de nom de domaine de l’utilisateur et le mot de passe.You can also specify the credentials of the user by using the user's domain name and password.

     // Connect by using the credentials of contoso/user1.
     service.Credentials = new WebCredentials("user1", "password", "contoso");
    

    Notes

    Si la propriété UseDefaultCredentials est définie sur true, la valeur de la propriété Credentials est ignorée.If the UseDefaultCredentials property is set to true, the value of the Credentials property is ignored.

  3. Définir l’URL du point de terminaison EWS.Set the URL of the EWS endpoint. Cette URL localise le fichier exchange.asmx sur le serveur d’accès au Client.This URL locates the exchange.asmx file on Client Access server.

     // Use Autodiscover to set the URL endpoint.
     service.AutodiscoverUrl("user1@contoso.com");
    

    Notes

    Vous pouvez définir explicitement la propriété Url de ExchangeService sur une valeur codée en dur, nous vous recommandons d’utiliser le service de découverte automatique au lieu de cela, pour les raisons suivantes : > découverte automatique détermine le point de terminaison meilleures pour un utilisateur donné (le point de terminaison le plus proche de serveur de boîtes aux lettres de l’utilisateur).Although you can explicitly set the Url property of the ExchangeService to a hardcoded value, we recommend that you use the Autodiscover service instead, for the following reasons: > Autodiscover determines the best endpoint for a given user (the endpoint that is closest to the user's Mailbox server). > L’URL EWS peut changer si les nouveaux serveurs d’accès au Client sont déployés.> The EWS URL might change if new Client Access servers are deployed. Dans ce scénario, l’utilisation d’Autodiscover signifie qu'aucune modification de code n’est nécessaires.In this scenario, using Autodiscover means no code changes are necessary. > Vous devez définir l’URL de manière explicite ou appel AutodiscoverUrl, mais vous ne devez pas effectuer les deux.> You should either set the URL explicitly or call AutodiscoverUrl, but you should not do both.

Voir aussiSee also