MessageQueue.Category Eigenschaft

Definition

Ruft die Kategorie der Warteschlange ab oder legt diese fest.Gets or sets the queue category.

public:
 property Guid Category { Guid get(); void set(Guid value); };
[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }
member this.Category : Guid with get, set
Public Property Category As Guid

Eigenschaftswert

Eine Guid, die die Kategorie der Warteschlange (Message Queuing-Typenbezeichner) darstellt und mit der eine Anwendung ihre Warteschlangen kategorisieren kann.A Guid that represents the queue category (Message Queuing type identifier), which allows an application to categorize its queues. Die Standardeinstellung ist Guid.empty.The default is Guid.empty.

Attribute

Ausnahmen

Die Kategorie der Warteschlange wurde auf einen ungültigen Wert festgelegt.The queue category was set to an invalid value.

Fehler beim Zugriff auf eine Message Queuing-Methode.An error occurred when accessing a Message Queuing method.

Beispiele

Im folgenden Codebeispiel wird der Wert der-Eigenschaft einer Nachrichten Warteschlange Category abgerufen und festgelegt.The following code example gets and sets the value of a message queue's Category property.

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

Hinweise

Mit der Kategorie Warteschlange kann eine Anwendung ihre Warteschlangen kategorisieren.The queue category allows an application to categorize its queues. Beispielsweise können Sie alle Abrechnungs Warteschlangen in einer Kategorie und alle Auftrags Warteschlangen in einer anderen Kategorie platzieren.For example, you can place all Billing queues in one category and all Order queues in another.

Die Category -Eigenschaft ermöglicht den Zugriff auf die Eigenschaft Message Queuing Type ID (Lese-/Schreibzugriff), auf die über das Dialogfeld Warteschlangen Eigenschaften in der Computer Verwaltungskonsole zugegriffen werden kann.The Category property provides access to the Message Queuing Type ID property (which is read/write), accessible through the Queue Properties dialog box in the Computer Management Console. Sie können eine neue Kategorie definieren.You can define a new category. Obwohl Sie verwenden NewGuid können, um einen Kategoriewert zu erstellen, Guid der für alle Werte eindeutig ist, ist eine solche Aktion nicht erforderlich.Although you can use NewGuid to create a category value that is unique across all Guid values, such an action is unnecessary. Der Kategoriewert muss sich nur von anderen Kategorien unterscheiden, nicht von Guid allen anderen Werten.The category value needs to be distinct only from other categories, not from all other Guid values. {00000000-0000-0000-0000-000000000001} Beispielsweise können Sie Category als für einen Satz Category von Warteschlangen und {00000000-0000-0000-0000-000000000002} als für einen anderen Satz zuweisen.For example, you can assign {00000000-0000-0000-0000-000000000001} as the Category for one set of queues and {00000000-0000-0000-0000-000000000002} as the Category for another set.

Es ist nicht erforderlich, den Categoryfestzulegen.It is not necessary to set the Category. Der Wert kann null sein.The value can be null.

Wenn Sie diese Eigenschaft festlegen, ändert sich die Message Queuing Warteschlange.Setting this property modifies the Message Queuing queue. Aus diesem Grund sind MessageQueue alle anderen Instanzen von der Änderung betroffen.Therefore, any other MessageQueue instances are affected by the change.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppen Modi verfügbar ist.The following table shows whether this property is available in various Workgroup modes.

Arbeitsgruppen ModusWorkgroup mode VerfügbarAvailable
Lokaler ComputerLocal computer JaYes
Name des lokalen Computers und des direkten FormatsLocal computer and direct format name JaYes
Remote ComputerRemote computer NeinNo
Name des Remote Computers und des direkten FormatsRemote computer and direct format name NeinNo

Gilt für:

Siehe auch