MessageQueue.Category Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

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

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
MessagingDescriptionAttribute

Excepciones

ArgumentException

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

MessageQueueException

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 que una aplicación clasifique sus colas. Por ejemplo, puede colocar todas las colas de facturación en una categoría y todas las colas de pedidos 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 que sea ú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 Sí
Equipo local y nombre de formato directo Sí
Equipo remoto No
Equipo remoto y nombre de formato directo No

Se aplica a

Consulte también