Partilhar via


<elemento de ponto> final

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>

Ver também