MessageQueue.Category Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property Category As GuidValore della proprietà
Oggetto Guid che rappresenta la categoria di coda (identificatore del tipo di accodamento messaggi), che consente a un'applicazione di classificare le code. Il valore predefinito è Guid.empty.
- Attributi
Eccezioni
La categoria della coda è stata impostata su un valore non valido.
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 della 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 degli ordini in un'altra.
La Category proprietà fornisce l'accesso alla proprietà ID tipo di accodamento messaggi ,che è di lettura/scrittura, accessibile tramite la finestra di dialogo Proprietà coda nella Console di gestione computer. È possibile definire una nuova categoria. Sebbene sia possibile usare NewGuid per creare un valore di categoria univoco in 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 per un set di code e {00000000-0000-0000-0000-000000000002} come Category per un altro set.
Non è necessario impostare .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ì |
| Computer locale e nome del formato diretto | Sì |
| Computer remoto | No |
| Computer remoto e nome del formato diretto | No |
