Compartilhar via


<udpAnnouncementEndpoint>

Um elemento de configuração define o ponto de extremidade padrão usado pelos serviços para enviar mensagens de comunicado por meio de uma associação UDP. Ele tem um contrato fixo e dá suporte a duas versões de descoberta. Além disso, ele tem uma associação de UDP fixa e um valor de endereço padrão, conforme as especificações do WS-Discovery (WS-Discovery de abril de 2005 ou WS-Discovery versão 1.1). Você pode especificar o endereço multicast a ser usado para enviar e receber as mensagens de comunicado.

<configuration>
  <system.serviceModel>
    <standardEndpoints>
      <udpAnnouncementEndpoint>

Syntax

<system.serviceModel>
  <standardEndpoints>
    <announcementEndpoint>
      <standardEndpoint discoveryVersion="WSDiscovery11/WSDiscoveryApril2005"
                        maxAnnouncementDelay="Timespan"
                        multicastAddress="Uri"
                        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.
multicastAddress Um URI que especifica um endereço multicast a ser usado para enviar e receber as mensagens de descoberta. O valor padrão é o endereço multicast conforme a especificação do protocolo.
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

Elemento Descrição
<udpTransportSettings> Uma coleção de configurações que permitem configurar o transporte UDP para o ponto de extremidade UDP.

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 o comunicado em um transporte multicast UDP com o endereço multicast padrão e o transporte multicast UDP com o endereço multicast especificado.

<services>
  <service name="ServiceAnnouncementListener">
    <endpoint name="udpAnnouncementEndpointStandard"
              kind="udpAnnouncementEndpoint"
              bindingConfiguration="..." />
    <endpoint name="udpAnnouncementEndpoint2"
              kind="udpAnnouncementEndpoint"
              endpointConfiguration="AnnouncementConfiguration3702"
              bindingConfiguration="..." />
    ...
  </service>
</services>
<standardEndpoints>
  <udpAnnouncementEndpoint>
    <standardEndpoint name="AnnouncementConfiguration2"
                      version="WSDiscoveryApril2005"
                      multicastAddress="soap.udp://239.255.255.250:3703"/>
  </udpAnnouncementEndpoint>
</standardEndpoints>

Confira também