Compartilhar via

Elemento <endpoint>

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

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

Sintaxe

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

Attributes

Attribute Description
address Uma cadeia de caracteres 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 Uma cadeia de caracteres que contém o nome do comportamento a ser usado no ponto de extremidade.
associação Atributo de cadeia de caracteres necessário que especifica o tipo de associação a ser usado. O tipo deve ter uma seção de configuração registrada para ser referenciado. O tipo é o registrado pelo nome da seção, em vez do nome do tipo da associação.
bindingConfiguration Uma cadeia de caracteres que especifica o nome da associação a ser usada quando o ponto de extremidade é instanciado. O nome da 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 binding uma configuração de associação específica no arquivo de configuração. Defina esse atributo se você estiver tentando usar uma associação personalizada. Caso contrário, uma exceção poderá ser gerada.
bindingName Uma cadeia de caracteres que especifica o nome qualificado exclusivo da associação para exportação de definição por meio do WSDL. O padrão é uma cadeia de caracteres vazia.
bindingNamespace Uma cadeia de caracteres que especifica o nome qualificado do namespace da associação para exportação de definição por meio do WSDL. O padrão é uma cadeia de caracteres vazia.
contrato Uma cadeia de caracteres que indica qual contrato esse 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 definido pelo kind atributo, que faz referência às informações de configuração adicionais desse ponto de extremidade padrão. O mesmo nome deve ser definido na <standardEndpoints> seção.
isSystemEndpoint Um valor booliano que especifica se um ponto de extremidade é um ponto de extremidade de infraestrutura.
variante Uma cadeia de caracteres que especifica o tipo de ponto de extremidade padrão aplicado. O tipo deve ser registrado na <extensions> seção ou em machine.config. Se nada for especificado, um ponto de extremidade de serviço comum será criado.
Listenurimode Especifica como o transporte trata o ListenUri fornecido para o serviço escutar. Valores válidos são

-Explícita
-Único

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.
nome 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 o 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 Description
<Cabeçalhos> Uma coleção de cabeçalhos de endereço.
<Identidade> Uma identidade que permite a autenticação de um ponto de extremidade por outros pontos de extremidade trocando mensagens com ele.

Elementos pai

Elemento Description
<Serviço> Uma seção de configuração que define uma lista de pontos de extremidade aos quais um cliente pode se conectar.

Example

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>

Consulte também

  • Last updated on