<endpoint> del <client>

Articolo
06/08/2023

Specifica proprietà di contratto, associazione e indirizzo dell'endpoint del canale usato dai client per connettersi agli endpoint del servizio nel server.

<Configurazione>
  <system.serviceModel>
    <Client>
      <Endpoint>

Sintassi

<endpoint address="String"
          behaviorConfiguration="String"
          binding="String"
          bindingConfiguration="String"
          contract="String"
          endpointConfiguration="String"
          kind="String"
          name="String">
</endpoint>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
address	Attributo stringa obbligatorio. Specifica l'indirizzo dell'endpoint. Il valore predefinito è una stringa vuota. L'indirizzo deve essere un URI assoluto.
behaviorConfiguration	Stringa che contiene il nome del comportamento da usare per creare un'istanza dell'endpoint. Il nome del comportamento deve essere nell'ambito del punto in cui il servizio è definito. Il valore predefinito è una stringa vuota.
binding	Attributo stringa obbligatorio. Stringa che indica il tipo di associazione da usare. Il tipo deve avere una sezione di configurazione registrata perché sia possibile farvi riferimento. Il tipo viene registrato in base al nome di sezione invece che al nome del tipo di associazione.
bindingConfiguration	Facoltativa. Stringa che contiene il nome della configurazione di associazione da usare quando viene creata un'istanza dell'endpoint. La configurazione di 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.
contract	Attributo stringa obbligatorio. Stringa che indica quale contratto viene esposto da questo endpoint. L'assembly deve implementare il tipo di contratto.
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>`.
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 del canale comune.
name	Attributo stringa facoltativo. L'attributo identifica in modo univoco un endpoint per un dato contratto. È possibile definire più client per un determinato tipo di contratto. Ogni definizione deve essere differenziata da un nome di configurazione univoco. Se questo attributo viene omesso, l'endpoint corrispondente viene usato come endpoint predefinito associato al tipo di contratto specificato. Il valore predefinito è una stringa vuota. L'attributo `name` di un'associazione viene usato per l'esportazione della definizione tramite WSDL.

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
<Client>	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 canale.

<endpoint address="/HelloWorld/"
          bindingConfiguration="usingDefaults"
          name="MyBinding"
          binding="customBinding"
          contract="HelloWorld">
</endpoint>