Elemento <endpoint>

  • Articolo

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

<system.serviceModel>
  <servizio>
    Elemento <endpoint>

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

Attributi ed elementi

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 utilizzato nell'associazione. Se non viene configurato un indirizzo, si presuppone che l'indirizzo di base valga come indirizzo per quell'endpoint.

L'impostazione predefinita è una stringa vuota.

behaviorConfiguration

Stringa che contiene il nome del comportamento da utilizzare nell'endpoint.

binding

Attributo stringa obbligatorio.

Specifica il tipo di associazione da utilizzare. 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 utilizzare quando viene creata l'istanza dell'endpoint. Il nome dell'associazione deve essere nell'ambito del punto in cui l'endpoint viene definito. L'impostazione predefinita è una stringa vuota.

Questo attributo viene utilizzato 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 utilizzare 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. L'impostazione predefinita è 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. L'impostazione predefinita è una stringa vuota.

contratto

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. L'impostazione predefinita è una stringa vuota.

listenUriMode

Specifica il modo in cui il trasporto considera l'elemento ListenUri fornito sul quale è in ascolto il servizio. I valori validi sono:

  • Explicit
  • Unique

Il valore predefinito è Explicit.

listenUri

Stringa che specifica l'URI sul quale è in ascolto l'endpoint del servizio. L'impostazione predefinita è una stringa vuota.

Elementi figlio

Elemento Descrizione

<intestazioni>

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

Vedere anche

Riferimenti

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

Altre risorse

Endpoints: Addresses, Bindings, and Contracts
How to: Create a Service Endpoint in Configuration