MessageQueue.Category Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Messaging
Assembly:
System.Messaging.dll

Ottiene o imposta la categoria della coda.

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

Valore della proprietà

Guid

Oggetto Guid che rappresenta la categoria della coda (identificatore del tipo di Accodamento messaggi), che consente a un'applicazione di suddividere per categoria le relative code. Il valore predefinito è Guid.empty.

Attributi
MessagingDescriptionAttribute

Eccezioni

ArgumentException

La categoria della coda è stata impostata su un valore non valido.

MessageQueueException

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

L'esempio di codice seguente ottiene e imposta il valore della proprietà di una coda di Category messaggi.

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

Commenti

La categoria di coda consente a un'applicazione di classificare le code. Ad esempio, è possibile inserire tutte le code di fatturazione in una categoria e tutte le code ordine in un'altra.

La Category proprietà fornisce l'accesso alla proprietà Message Queuing Type ID (che è di lettura/scrittura), accessibile tramite la finestra di dialogo Proprietà coda nella Console di gestione computer. È possibile definire una nuova categoria. Anche se è possibile usare NewGuid per creare un valore di categoria univoco per tutti i Guid valori, tale azione non è necessaria. Il valore della categoria deve essere distinto solo da altre categorie, non da tutti gli altri Guid valori. Ad esempio, è possibile assegnare {00000000-0000-0000-0000-000000000001} come Category set di code e {00000000-0000-0000-0000-000000000002} come Category per un altro set.

Non è necessario impostare l'oggetto Category. Il valore può essere null.

L'impostazione di questa proprietà modifica la coda Accodamento messaggi. Pertanto, tutte le altre MessageQueue istanze sono interessate dalla modifica.

Nella tabella seguente viene illustrato se questa proprietà è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale Sì
Nome del computer locale e del formato diretto Sì
Computer remoto No
Nome del formato diretto e del computer remoto No

Si applica a

Vedi anche