<ponto de extremidade> do <cliente>

Artigo
06/08/2023

Especifica contrato, associação e propriedades de endereço do ponto de extremidade do canal, que é usado por clientes para se conectar a pontos de extremidade de serviço no servidor.

<configuration>
  <system.serviceModel>
    <client>
      <endpoint>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
address	Atributo de cadeia de caracteres obrigatório. Especifica o endereço do ponto de extremidade. O padrão é uma cadeia de caracteres vazia. O endereço deve ser um URI absoluto.
behaviorConfiguration	Uma cadeia de caracteres que contém o nome do comportamento do comportamento a ser usado para instanciar o ponto de extremidade. O nome do comportamento deve estar no escopo no ponto em que o serviço é definido. O padrão é uma cadeia de caracteres vazia.
associação	Atributo de cadeia de caracteres obrigatório. Uma cadeia de caracteres que indica o tipo de associação a usar. O tipo deve ter uma seção de configuração registrada para ser referenciado. O tipo é registrado pelo nome da seção, em vez do nome do tipo da associação.
bindingConfiguration	Opcional. Uma cadeia de caracteres que contém o nome da configuração da associação a ser utilizada quando o ponto de extremidade é instanciado. A configuração de associação deve estar no escopo no ponto em que o ponto de extremidade é definido. O padrão é uma cadeia de caracteres vazia. Esse atributo é usado em conjunto com a `binding` para referenciar uma configuração de associação específica no arquivo de configuração. Configure esse atributo se estiver tentando usar uma associação personalizada. Caso contrário, uma exceção poderá ser gerada.
contrato	Atributo de cadeia de caracteres obrigatório. Uma cadeia de caracteres que indica qual contrato este ponto de extremidade está expondo. O assembly deve implementar o tipo de contrato.
endpointConfiguration	Uma cadeia de caracteres que especifica o nome do ponto de extremidade padrão que é definido pelo atributo`kind`, que faz referência às informações de configuração adicionais deste ponto de extremidade padrão. O mesmo nome deve ser definido na seção `<standardEndpoints>`.
kind	Uma cadeia de caracteres que especifica o tipo de ponto de extremidade padrão aplicado. O tipo deverá ser registrado na seção `<extensions>` ou em machine.config. Caso nada seja especificado, um ponto de extremidade de canal comum será criado.
name	Atributo de cadeia de caracteres opcional. Esse atributo identifica exclusivamente um ponto de extremidade de um determinado contrato. É possível definir vários clientes de um determinado tipo de contrato. Cada definição deve ser diferenciada por um nome de configuração exclusivo. Se esse atributo for omitido, o ponto de extremidade correspondente será usado como o ponto de extremidade padrão associado ao tipo de contrato especificado. O padrão é uma cadeia de caracteres vazia. O atributo `name` de uma associação é usado para exportação de definição por meio de WSDL.

Elementos filho

Elemento	Descrição
<headers>	Uma coleção de cabeçalhos de endereço.
<identity>	Uma identidade que permite a autenticação de um ponto de extremidade por outros pontos de extremidade que trocam mensagens com ele.

Elementos pai

Elemento	Descrição
<client>	Uma seção de configuração que define uma lista de pontos de extremidade que um cliente pode conectar.

Exemplo

Esse é um exemplo de uma configuração de ponto de extremidade de canal.

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

Compartilhar via