Partilhar via


<announcementEndpoint>

Este elemento de configuração define um ponto final padrão com um contrato de anúncio fixo. Opcionalmente, um serviço pode anunciar a sua disponibilidade ao enviar uma mensagem de anúncio online e offline quando é aberto ou fechado, respetivamente. Um serviço Windows Communication Foundation (WCF) especifica os pontos finais de anúncio no <elemento serviceDiscovery> e utiliza o AnnouncementClient para efetuar os anúncios. Um cliente que pretenda escutar o anúncio de outro serviço está, na verdade, a agir como um serviço WCF; assim, tem de configurar os pontos finais de anúncio para esse cliente na <secção de serviços> .

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

Atributos

Atributo Descrição
discoveryVersion Uma cadeia que especifica uma das duas versões do protocolo WS-Discovery. Os valores válidos são WSDiscovery11 e WSDiscoveryApril2005. Este valor é do tipo DiscoveryVersion.
maxAnnouncementDelay Um valor de Período de Tempo que especifica o valor máximo para o atraso que o protocolo de Deteção aguardará antes de enviar uma mensagem Hello. As mensagens aguardarão um valor de tempo aleatório entre 0 e o valor deste atributo antes de serem enviadas. Este atributo é utilizado para definir um pequeno atraso aleatório para evitar tempestades de rede quando uma rede sai e todos os serviços voltam a ficar online ao mesmo tempo.
name Uma Cadeia que especifica o nome da configuração do ponto final padrão. O nome é utilizado no endpointConfiguration atributo do ponto final de serviço para ligar um ponto final padrão à respetiva configuração.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
<standardEndpoints> Foi corrigida uma coleção de pontos finais padrão que são pontos finais predefinidos com uma ou mais das respetivas propriedades (endereço, enlace, contrato).

Exemplo

O exemplo seguinte demonstra um cliente a escutar mensagens de anúncios através de http e peernet.

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

Ver também