MessageQueue.Category Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém 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 da propriedade

Guid

Um Guid que representa a categoria de fila (identificador de tipo de Enfileiramento de Mensagens), que permite que um aplicativo categorize suas filas. O padrão é Guid.empty.

Atributos

MessagingDescriptionAttribute

Exceções

ArgumentException

A categoria de fila foi definida como um valor inválido.

MessageQueueException

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de Category 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);

Comentários

A categoria de fila permite que um aplicativo categorize suas filas. Por exemplo, você pode colocar todas as filas de cobrança em uma categoria e todas as filas de pedidos em outra.

A Category propriedade fornece acesso à propriedade ID do Tipo de Enfileiramento de Mensagens (que é leitura/gravação), acessível por meio da caixa de diálogo Propriedades da Fila no Console de Gerenciamento do Computador. Você pode definir uma nova categoria. Embora você possa usar NewGuid para criar um valor de categoria exclusivo em todos os Guid valores, essa ação é desnecessária. O valor da categoria precisa ser distinto apenas de outras categorias, não de todos os outros Guid valores. Por exemplo, você pode 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 essa propriedade modifica a fila de Enfileiramento de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela alteração.

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

Confira também

• Id
• Label
• GetPublicQueues()