Elemento <endpoint>

Articolo
02/27/2011

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

Gerarchia dello schema

<system.serviceModel>
<servizio>
Elemento <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 attributi, elementi figlio ed 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 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 che 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 singolo tipo di contratto, questa proprietà può essere omessa. L'impostazione predefinita è 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 specificato, viene creato un endpoint del 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: 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.
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
<intestazioni>	Raccolta 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

Riferimento

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

Altre risorse

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

Condividi tramite