Compartir a través de


MessageQueue.Category Propiedad

Definición

Obtiene o establece la categoría de la cola.

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 propiedad

Guid que representa la categoría de la cola (identificador de tipo de Message Queuing), lo que permite que una aplicación clasifique sus colas por categorías. De manera predeterminada, es Guid.empty.

Atributos

Excepciones

La categoría de la cola se estableció en un valor incorrecto.

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de una cola de Category mensajes.

// 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);

Comentarios

La categoría de cola permite a una aplicación clasificar sus colas. Por ejemplo, puede colocar todas las colas de facturación en una categoría y todas las colas order en otra.

La Category propiedad proporciona acceso a la propiedad Message Queuing Type ID (que es de lectura y escritura), accesible a través del cuadro de diálogo Propiedades de la cola en la Consola de administración de equipos. Puede definir una nueva categoría. Aunque puede usar NewGuid para crear un valor de categoría único en todos los Guid valores, esta acción no es necesaria. El valor de categoría solo debe ser distinto de otras categorías, no de todos los demás Guid valores. Por ejemplo, puede asignar {00000000-0000-0000-0000-000000000001} como para Category un conjunto de colas y {00000000-0000-0000-0000-000000000002} como para Category otro conjunto.

No es necesario establecer .Category El valor puede ser null.

Al establecer esta propiedad, se modifica la cola message Queuing. Por lo tanto, cualquier otra MessageQueue instancia se ve afectada por el cambio.

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo Disponible
Equipo local
Equipo local y nombre de formato directo
Equipo remoto No
Equipo remoto y nombre de formato directo No

Se aplica a

Consulte también