<ponto de extremidade> do <cliente>

  • Artigo

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

Confira também