elemento de <ponto de extremidade>

Artigo
06/08/2023

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