Compartilhar via


<announcementEndpoint>

Esse elemento de configuração define um ponto de extremidade padrão com um contrato de anúncio fixo. Opcionalmente, um serviço pode anunciar sua disponibilidade enviando uma mensagem de anúncio online e offline quando é aberto ou fechado, respectivamente. Um serviço WCF (Windows Communication Foundation) especifica os pontos de extremidade de anúncio no <elemento serviceDiscovery> e usa o AnnouncementClient para executar os anúncios. Um cliente que deseja escutar o comunicado de outro serviço está realmente atuando como um serviço WCF; portanto, você precisa configurar os pontos de extremidade de anúncio para esse cliente na seção <serviços>.

<configuration>
  <system.serviceModel>
    <standardEndpoints>
      <announcementEndpoint>

Syntax

<system.serviceModel>
  <standardEndpoints>
    <announcementEndpoint>
      <standardEndpoint discoveryVersion="WSDiscovery11/WSDiscoveryApril2005"
                        maxAnnouncementDelay="Timespan"
                        name="String" />
    </announcementEndpoint>
  </standardEndpoints>
</system.serviceModel>

Atributos e elementos

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

Atributos

Atributo Descrição
discoveryVersion Uma cadeia de caracteres que especifica uma das duas versões do protocolo WS-Discovery. Os valores válidos são WSDiscovery11 e WSDiscoveryApril2005. Esse valor é do tipo DiscoveryVersion.
maxAnnouncementDelay Um valor de Timespan que especifica o valor máximo para o atraso que o protocolo Discovery aguardará antes de enviar uma mensagem Hello. As mensagens aguardarão um valor temporal aleatório entre 0 e o valor desse atributo antes de serem enviadas. Esse atributo é usado para definir um pequeno atraso aleatório a fim de evitar tempestades de rede quando uma rede fica inativa e todos os serviços voltam a ficar online ao mesmo tempo.
name Uma cadeia de caracteres que especifica o nome da configuração do ponto de extremidade padrão. O nome é usado no atributo endpointConfiguration do ponto de extremidade de serviço para vincular um ponto de extremidade padrão à respectiva configuração.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
<standardEndpoints> Uma coleção de pontos de extremidade padrão que são pontos de extremidade predefinidos com uma ou mais de suas propriedades (endereço, associação, contrato) corrigidos.

Exemplo

O exemplo a seguir demonstra um cliente escutando mensagens de anúncios por http e parnet.

<services>
  <service name="ServiceAnnouncementListener">
    <endpoint name="httpAnnouncementEndpoint"
              kind="announcementEndpoint"
              binding="basicHttpBinding"
              address="announcements" />
    <endpoint name="peerNetAnnouncementEndpoint"
              kind="announcementEndpoint"
              binding="peerTcpBinding"
              address="net.p2p://discoveryMesh/multicast"
              bindingConfiguration="discoveryPeerTcpBindingConfig" />
  ...
  </service>
</services>

<standardEndpoints>
  <announcementEndpoint>
    <standardEndpoint name="httpAnnouncementEndpoint"
                      version="WSDiscoveryApril2005" />
    <standardEndpoint name="peerNetAnnouncementEndpoint"
                      version="WSDiscoveryApril2005" />
  </announcementEndpoint>
</standardEndpoints>

Confira também