Condividi tramite


<elemento endpoint>

Specifica le proprietà di associazione, contratto e indirizzo di endpoint del servizio usato per esporre servizi.

<Configurazione>
  <system.serviceModel>
    <Servizi>
      <Servizio>
        <Endpoint>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
address Stringa che contiene l'indirizzo dell'endpoint. L'indirizzo può essere specificato come indirizzo assoluto o relativo. Se viene fornito un indirizzo relativo, l'host deve fornire un indirizzo di base appropriato per lo schema di trasporto usato nell'associazione. Se non viene configurato un indirizzo, si presuppone che l'indirizzo di base valga come indirizzo per quell'endpoint.

Il valore predefinito è una stringa vuota.
behaviorConfiguration Stringa che contiene il nome del comportamento da usare nell'endpoint.
binding Attributo stringa obbligatorio che specifica il tipo di associazione da usare. Il tipo deve avere una sezione di configurazione registrata perché sia possibile farvi riferimento. Il tipo viene registrato dal nome di sezione, anziché dal nome del tipo di associazione.
bindingConfiguration Stringa che specifica il nome dell'associazione da usare quando viene creata l'istanza dell'endpoint. Il nome dell'associazione deve essere nell'ambito del punto in cui l'endpoint viene definito. Il valore predefinito è una stringa vuota.

Questo attributo viene usato in combinazione con binding per fare riferimento a una configurazione di associazione specifica nel file di configurazione. Impostare questo attributo se si sta tentando di usare un'associazione personalizzata. In caso contrario, può venire generata un'eccezione.
bindingName Stringa che specifica il nome completo e univoco dell'associazione per l'esportazione delle definizioni tramite WSDL. Il valore predefinito è una stringa vuota.
bindingNamespace Stringa che specifica il nome completo e univoco dello spazio dei nomi dell'associazione per l'esportazione delle definizioni tramite WSDL. Il valore predefinito è una stringa vuota.
contract Stringa che indica quale contratto viene esposto da questo endpoint. L'assembly deve implementare il tipo di contratto. Se un'implementazione del servizio implementa un tipo di contratto singolo, questa proprietà può essere omessa. Il valore predefinito è una stringa vuota.
endpointConfiguration Stringa che specifica il nome dell'endpoint standard impostato dall'attributo kind che fa riferimento alle informazioni di configurazione aggiuntive di questo endpoint standard. Lo stesso nome deve essere definito nella sezione <standardEndpoints>.
isSystemEndpoint Valore booleano che specifica se un endpoint è un endpoint di infrastruttura.
kind Stringa che specifica il tipo di endpoint standard applicato. Il tipo deve essere registrato nella sezione <extensions> o in machine.config. Se non viene specificato alcun valore, viene creato un endpoint di servizio comune.
listenUriMode Specifica il modo in cui il trasporto considera l'elemento ListenUri fornito sul quale è in ascolto il servizio. I valori validi sono:

-Esplicito
-Unico

Il valore predefinito è Explicit.
listenUri Stringa che specifica l'URI sul quale è in ascolto l'endpoint del servizio. Il valore predefinito è una stringa vuota.
name Attributo facoltativo. Stringa che specifica il nome dell'endpoint del servizio. Il valore predefinito è costituito dalla concatenazione del nome dell'associazione e del nome della descrizione del contratto. È possibile che i servizi siano dotati di più endpoint, quindi l'attributo name dell'endpoint si differenzia dal nome del servizio.

Elementi figlio

Elemento Descrizione
<headers> Raccolte di intestazioni di indirizzo.
<Identità> Identità che consente l'autenticazione di un endpoint da altri endpoint con i quali vengono scambiati messaggi.

Elementi padre

Elemento Descrizione
<Servizio> Sezione di configurazione che definisce un elenco di endpoint ai quali può connettersi un client.

Esempio

Di seguito è riportato un esempio di configurazione dell'endpoint di un servizio.

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

Vedi anche