Partager via


<endpoint>, élément

Spécifie la liaison, le contrat et les propriétés d’adresse d’un point de terminaison de service, utilisé pour exposer des services.

<configuration>
  <system.serviceModel>
    <services>
      <service>
        <endpoint>

Syntaxe

<endpoint address="String"
          behaviorConfiguration="String"
          binding="String"
          bindingConfiguration="String"
          bindingName="String"
          bindingNamespace="String"
          contract="String"
          endpointConfiguration="String"
          isSystemEndpoint="Boolean"
          kind="String"
          listenUriMode="Explicit/Unique"
          listenUri="Uri">
</endpoint>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
address Chaîne qui contient l'adresse du point de terminaison. L'adresse peut être spécifiée comme une adresse absolue ou relative. Si une adresse relative est fournie, l'hôte doit fournir une adresse de base appropriée au schéma de transport utilisé dans la liaison. Si une adresse n'est pas configurée, l'adresse de base est l'adresse pour ce point de terminaison.

La valeur par défaut est une chaîne vide.
behaviorConfiguration Chaîne qui contient le nom du comportement à utiliser au point de terminaison.
liaison de sortie Attribut de chaîne requis indiquant le type de liaison à utiliser. Ce type doit posséder une section de configuration inscrite pour pouvoir être référencé. Il est inscrit en fonction du nom de la section et non en fonction du nom du type de la liaison.
bindingConfiguration Chaîne qui spécifie le nom de la liaison à utiliser lorsque le point de terminaison est instancié. Le nom de liaison doit être dans la portée, au niveau où le point de terminaison est défini. La valeur par défaut est une chaîne vide.

Cet attribut est utilisé conjointement à binding pour référencer une configuration de liaison spécifique dans le fichier de configuration. Définissez cet attribut si vous essayez d’utiliser une liaison personnalisée. Sinon, une exception peut être levée.
bindingName Chaîne qui spécifie le nom qualifié unique de la liaison pour l’exportation de définition à travers WSDL. La valeur par défaut est une chaîne vide.
bindingNamespace Chaîne qui spécifie le nom qualifié de l’espace de noms de la liaison pour l’exportation de définition à travers WSDL. La valeur par défaut est une chaîne vide.
contract Chaîne qui indique le contrat exposé par ce point de terminaison. L'assembly doit implémenter le type de contrat. Si une implémentation de service implémente un seul type de contrat, cette propriété peut alors être omise. La valeur par défaut est une chaîne vide.
endpointConfiguration Chaîne qui spécifie le nom du point de terminaison standard défini par l'attribut kind, qui fait référence aux informations de configuration supplémentaires de ce point de terminaison standard. Le même nom doit être défini dans la section <standardEndpoints>.
isSystemEndpoint Valeur booléenne qui spécifie si un point de terminaison est un point de terminaison d'infrastructure.
kind Chaîne qui spécifie le type de point de terminaison standard appliqué. Le type doit être inscrit dans la section <extensions> ou dans machine.config. Si rien n’est spécifié, un point de terminaison de service commun est créé.
listenUriMode Spécifie la manière dont le transport traite le ListenUri fourni sur lequel le service effectue son écoute. Les valeurs valides sont les suivantes :

- Explicit
- Unique

La valeur par défaut est Explicit.
listenUri Chaîne qui spécifie l'URI au niveau duquel le point de terminaison de service effectue son écoute. La valeur par défaut est une chaîne vide.
name Attribut facultatif. Chaîne qui spécifie le nom du point de terminaison du service. La valeur par défaut correspond à la concaténation du nom de la liaison et de celui de la description du contrat. Les services peuvent disposer de plusieurs points de terminaison, l'attribut name du point de terminaison est donc différent du nom du service.

Éléments enfants

Élément Description
<headers> Collection d'en-têtes d'adresses.
<identity> Identité qui permet l'authentification d'un point de terminaison par les autres points de terminaison qui échangent des messages avec lui.

Éléments parents

Élément Description
<service> Section de configuration qui définit une liste des points de terminaison auxquels un client peut se connecter.

Exemple

Il s'agit d'un exemple de configuration de point de terminaison de service.

<endpoint address="/HelloWorld/"
          bindingConfiguration="usingDefaults"
          bindingName="MyBinding"
          binding="customBinding"
          contract="HelloWorld">
  <headers>
    <region xmlns="http://tempuri.org/">EastCoast</region>
    <member xmlns="http://tempuri.org/">Gold</member>
  </headers>
</endpoint>

Voir aussi