MessageQueue.MulticastAddress Propriedade
Definição
Introduzido no MSMQ 3.0.Introduced in MSMQ 3.0. Obtém ou define o endereço multicast associado à fila.Gets or sets the multicast address associated with the queue.
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
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.A String that contains a valid multicast address (in the form shown below) or null, which indicates that the queue is not associated with a multicast address.
<address>:<port>
- Atributos
Exceções
O MSMQ 3.0 não está instalado.MSMQ 3.0 is not installed.
Comentários
A MulticastAddress propriedade é usada para associar uma fila não transacional com um endereço multicast que pode ser usado ao enviar mensagens.The MulticastAddress property is used to associate a non-transactional queue with a multicast address that can be used when sending messages. Não é possível associar uma fila transacional a um endereço multicast.You cannot associate a transactional queue with a multicast address. Quando o aplicativo de envio envia mensagens para um endereço de multicast, o serviço de enfileiramento de mensagens envia uma cópia da mensagem para cada fila associada a esse endereço.When the sending application sends messages to a multicast address, Message Queuing sends a copy of the message to every queue associated with that address.
Os endereços IP multicast devem estar no intervalo de classe D de 224.0.0.0 a 239.255.255.255, que corresponde à definição dos quatro primeiros bits de ordem superior igual a 1110.IP multicast addresses must be in the class D range from 224.0.0.0 to 239.255.255.255, which corresponds to setting the first four high-order bits equal to 1110. No entanto, apenas determinados intervalos de endereços nesse intervalo não são reservados e estão disponíveis para envio de mensagens multicast.However, only certain ranges of addresses in this range are unreserved and available for sending multicast messages. Para obter a lista mais recente de endereços de multicast reservados, consulte a página da Web endereços de multicast da Internet atribuídos pela Internet (IANA) .For the latest list of reserved multicast addresses, see the Internet Assigned Number Authority (IANA) Internet Multicast Addresses Web page. Não há restrições no número da porta.There are no restrictions on the port number.
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 da porta.If several source computers are sending multicast messages and you want a specific queue to receive messages from only one source computer, each source computer must send messages to a different combination of IP address and port number.
Para dissociar uma fila de um endereço multicast, defina a MulticastAddress propriedade como uma cadeia de caracteres de comprimento zero.To dissociate a queue from a multicast address, set the MulticastAddress property to a zero-length string. Não null o defina como, pois isso resultará em um ArgumentNullException .Do not set it to null, as this will result in a ArgumentNullException.
A tabela a seguir mostra se essa propriedade está disponível em vários modos de grupo de trabalho.The following table shows whether this property is available in various Workgroup modes.
| Modo de grupo de trabalhoWorkgroup mode | DisponívelAvailable |
|---|---|
| Computador localLocal computer | YesYes |
| Computador local e nome de formato diretoLocal computer and direct format name | YesYes |
| Computador remotoRemote computer | NãoNo |
| Computador remoto e nome de formato diretoRemote computer and direct format name | NãoNo |