Partilhar via


<udpAnnouncementEndpoint>

Este elemento de configuração define um ponto final padrão que é utilizado pelos serviços para enviar mensagens de anúncio através de um enlace UDP. Tem um contrato fixo e suporta duas versões de deteção. Além disso, tem um enlace UDP fixo e um valor de endereço predefinido conforme especificado nas especificações de WS-Discovery (WS-Discovery abril de 2005 ou WS-Discovery versão 1.1). Pode especificar o endereço multicast a utilizar para enviar e receber as mensagens de anúncio.

<configuração>
  <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 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.
multicastAddress Um URI que especifica um endereço multicast a utilizar para enviar e receber as mensagens de deteção. O valor predefinido é o endereço multicast conforme à especificação do protocolo.
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

Elemento Descrição
<udpTransportSettings> Uma coleção de definições que lhe permite configurar o transporte UDP para o ponto final UDP.

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 o anúncio através de um transporte multicast UDP com o endereço multicast predefinido e o transporte multicast UDP com um 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>

Ver também