<elemento de ponto> final

Artigo
06/08/2023

Especifica propriedades de enlace, contrato e endereço para um ponto final de serviço, que é utilizado para expor serviços.

<configuração>
  <system.serviceModel>
    <serviços>
      <serviço>
        <ponto final>

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 secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
address	Uma cadeia que contém o endereço do ponto final. O endereço pode ser especificado como um endereço absoluto ou relativo. Se for fornecido um endereço relativo, espera-se que o anfitrião forneça um endereço base adequado para o sistema de transporte utilizado no enlace. Se um endereço não estiver configurado, assume-se que o endereço base é o endereço desse ponto final. A predefinição é uma cadeia vazia.
behaviorConfiguration	Uma cadeia que contém o nome do comportamento a ser utilizado no ponto final.
binding	Atributo de cadeia necessário que especifica o tipo de enlace a utilizar. O tipo tem de ter uma secção de configuração registada para ser referenciado. O tipo é o registado pelo nome da secção, em vez do nome do tipo do enlace.
bindingConfiguration	Uma cadeia que especifica o nome de enlace do enlace a utilizar quando o ponto final é instanciado. O nome do enlace tem de estar no âmbito no ponto em que o ponto final está definido. A predefinição é uma cadeia vazia. Este atributo é utilizado em conjunto com `binding` para referenciar uma configuração de enlace específica no ficheiro de configuração. Defina este atributo se estiver a tentar utilizar um enlace personalizado. Caso contrário, poderá ser emitida uma exceção.
bindingName	Uma cadeia que especifica o nome qualificado exclusivo do enlace para exportação de definições através do WSDL. A predefinição é uma cadeia vazia.
bindingNamespace	Uma cadeia que especifica o nome qualificado do espaço de nomes do enlace para exportação de definições através do WSDL. A predefinição é uma cadeia vazia.
contrato	Uma cadeia que indica que contrato este ponto final está a expor. A assemblagem tem de implementar o tipo de contrato. Se uma implementação de serviço implementar um único tipo de contrato, esta propriedade pode ser omitida. A predefinição é uma cadeia vazia.
endpointConfiguration	Uma cadeia que especifica o nome do ponto final padrão que é definido pelo `kind` atributo, que faz referência às informações de configuração adicionais deste ponto final padrão. O mesmo nome tem de ser definido na `<standardEndpoints>` secção.
isSystemEndpoint	Um valor booleano que especifica se um ponto final é um ponto final de infraestrutura.
tipo	Uma cadeia que especifica o tipo de ponto final padrão aplicado. O tipo tem de estar registado na `<extensions>` secção ou no machine.config. Se nada for especificado, é criado um ponto final de serviço comum.
listenUriMode	Especifica a forma como o transporte trata o `ListenUri` fornecido para o serviço escutar. Os valores válidos são - Explícito - Exclusivo O valor predefinido é Explícito.
listenUri	Uma cadeia que especifica o URI no qual o ponto final de serviço escuta. A predefinição é uma cadeia vazia.
name	Atributo opcional. Uma cadeia que especifica o nome do ponto final de serviço. O valor predefinido é a concatenação do nome do enlace e o nome da descrição do contrato. Os serviços podem ter vários pontos finais, pelo que o atributo do `name` ponto final é distinto do nome do serviço.

Elementos Subordinados

Elemento	Descrição
<cabeçalhos>	Uma coleção de cabeçalhos de endereço.
<identidade>	Uma identidade que permite a autenticação de um ponto final por outros pontos finais que trocam mensagens com o mesmo.

Elementos Principais

Elemento	Descrição
<serviço>	Uma secção de configuração que define uma lista de pontos finais aos quais um cliente se pode ligar.

Exemplo

Este é um exemplo de uma configuração de ponto final 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>

Partilhar via