MessageQueue.Category Propriedade

Definição

Espaço de Nomes:
System.Messaging
Assemblagem:
System.Messaging.dll

Recebe ou define a categoria da fila.

public:
 property Guid Category { Guid get(); void set(Guid value); };
[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }
[<System.Messaging.MessagingDescription("MQ_Category")>]
member this.Category : Guid with get, set
Public Property Category As Guid

Valor de Propriedade

Guid

A Guid que representa a categoria da fila (identificador do tipo Fila de Mensagens), que permite a uma aplicação categorizar as suas filas. A predefinição é Guid.empty.

Atributos
MessagingDescriptionAttribute

Exceções

ArgumentException

A categoria da fila foi definida para um valor inválido.

MessageQueueException

Ocorreu um erro ao aceder a um método de Fila de Mensagens.

Exemplos

O seguinte exemplo de código obtém e define o valor da propriedade de Category uma fila de mensagens.

// Set the queue's Category property value.
queue.Category =
    new System.Guid("00000000-0000-0000-0000-000000000001");

// Display the new value of the queue's Category property.
Console.WriteLine("MessageQueue.Category: {0}", queue.Category);

Observações

A categoria de fila permite que uma aplicação categorize as suas filas. Por exemplo, pode colocar todas as filas de Faturação numa categoria e todas as filas de Encomendas noutra.

A Category propriedade fornece acesso à propriedade ID do Tipo de Fila de Mensagens (que é leitura/escrita), acessível através da caixa de diálogo Propriedades da Fila na Console de Gestão do Computador. Podes definir uma nova categoria. Embora possa usar NewGuid para criar um valor de categoria único em todos os Guid valores, tal ação é desnecessária. O valor da categoria precisa de ser distinto apenas das outras categorias, não de todos os outros Guid valores. Por exemplo, podes atribuir {00000000-0000-0000-0000-000000000001} como o Category para um conjunto de filas e {00000000-0000-0000-0000-000000000002} como o Category para outro conjunto.

Não é necessário definir o Category. O valor pode ser null.

Definir esta propriedade modifica a fila de Fila de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela mudança.

A tabela seguinte mostra se esta propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Available
Computador local Yes
Computador local e nome do formato direto Yes
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Ver também