MessageQueue.MulticastAddress Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Introduzido no MSMQ 3.0. Obtém ou define o endereço multicast associado à fila.

public:
 property System::String ^ MulticastAddress { System::String ^ get(); void set(System::String ^ value); };

[System.Messaging.MessagingDescription("MQ_MulticastAddress")]
public string MulticastAddress { get; set; }

[<System.Messaging.MessagingDescription("MQ_MulticastAddress")>]
member this.MulticastAddress : string with get, set

Public Property MulticastAddress As String

Valor da propriedade

String

Um String que contém um endereço multicast válido (no formato mostrado abaixo) ou null, que indica que a fila não está associada a um endereço multicast.

<address>:<port>

Atributos

MessagingDescriptionAttribute

Exceções

PlatformNotSupportedException

O MSMQ 3.0 não está instalado.

Comentários

A MulticastAddress propriedade é usada para associar uma fila não transacional a um endereço multicast que pode ser usado ao enviar mensagens. Você não pode associar uma fila transacional a um endereço multicast. Quando o aplicativo de envio envia mensagens para um endereço multicast, o Enfileiramento de Mensagens envia uma cópia da mensagem para cada fila associada a esse endereço.

Os endereços multicast IP devem estar no intervalo da classe D de 224.0.0.0 a 239.255.255.255, o que corresponde à definição dos quatro primeiros bits de ordem alta igual a 1110. No entanto, apenas determinados intervalos de endereços nesse intervalo não são atendidos e estão disponíveis para enviar mensagens multicast. Para obter a lista mais recente de endereços multicast reservados, consulte a página da Web Endereços Multicast da Internet IANA (Internet Assigned Number Authority). Não há restrições no número da porta.

Se vários computadores de origem estiverem enviando mensagens multicast e você quiser que uma fila específica receba mensagens de apenas um computador de origem, cada computador de origem deverá enviar mensagens para uma combinação diferente de endereço IP e número de porta.

Para desassociar uma fila de um endereço multicast, defina a MulticastAddress propriedade como uma cadeia de caracteres de comprimento zero. Não o defina nullcomo , pois isso resultará em um ArgumentNullException.

A tabela a seguir mostra se essa propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho	Disponível
Computador local	Yes
Nome do computador local e do formato direto	Yes
Computador remoto	Não
Computador remoto e nome de formato direto	Não