Compartilhar via


elemento de <ponto de extremidade>

Especifica associação, contrato e propriedades de endereço para um ponto de extremidade de serviço, que é usado para expor serviços.

<configuration>
  <system.serviceModel>
    <services>
      <service>
        <endpoint>

Syntax

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

Atributos e elementos

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

Atributos

Atributo Descrição
address Um URI que contém o endereço do ponto de extremidade. O endereço pode ser especificado como um endereço absoluto ou relativo. Se um endereço relativo for fornecido, espera-se que o host forneça um endereço base apropriado para o esquema de transporte usado na associação. Se um endereço não estiver configurado, o endereço base será considerado o endereço desse ponto de extremidade.

O padrão é uma cadeia de caracteres vazia.
behaviorConfiguration Obtém ou define uma cadeia de caracteres que contém o nome do comportamento a ser usado para o ponto de extremidade.
associação Atributo de cadeia de caracteres exigido que especifica o tipo de associação a ser usada. O tipo deve ter uma seção de configuração registrada para ser referenciado. O tipo é o nome registrado por seção, em vez do nome do tipo da associação.
bindingConfiguration Obtém ou define uma cadeia de caracteres que contém o nome de associação da associação a ser usada 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.
bindingName Obtém ou define uma cadeia de caracteres que define o nome qualificado da associação para exportação de definição por meio de WSDL. O padrão é uma cadeia de caracteres vazia.
bindingNamespace Obtém ou define uma cadeia de caracteres que especifica o nome qualificado do namespace da associação para exportação de definição por meio de WSDL. O padrão é uma cadeia de caracteres vazia.
contrato Uma cadeia de caracteres que indica qual contrato este ponto de extremidade está expondo. O assembly deve implementar o tipo de contrato. Se uma implementação de serviço implementar um único tipo de contrato, essa propriedade poderá ser omitida. O padrão é uma cadeia de caracteres vazia.
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>.
isSystemEndpoint Um valor booleano que especifica se um ponto de extremidade é um ponto de extremidade de infraestrutura.
kind Uma cadeia de caracteres que especifica o tipo de ponto de extremidade padrão aplicado. O tipo deve ser registrado na seção <extensions> ou no machine.config. Se nada for especificado, um ponto de extremidade de serviço comum será criado.
listenUriMode Obtém ou define um valor que especifica como o transporte trata o ListenUri fornecido para o serviço escutar. Os valores válidos são

- Explícito
- Exclusivo

O valor padrão é Explicit.
listenUri Uma cadeia de caracteres que especifica o URI no qual o ponto de extremidade de serviço escuta. O padrão é uma cadeia de caracteres vazia.
name Atributo opcional. Uma cadeia de caracteres que especifica o nome do ponto de extremidade de serviço. O valor padrão é a concatenação do nome da associação e do nome da descrição do contrato. Os serviços podem ter vários pontos de extremidade, portanto, o atributo do ponto de name extremidade é distinto do nome do serviço.

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
<service> Uma seção de configuração que define uma lista de pontos de extremidade que um cliente pode conectar.

Exemplo

Este é um exemplo de uma configuração de ponto de extremidade de serviço.

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

Confira também