Freigeben über


MessageQueue.Category Eigenschaft

Definition

Ruft die Kategorie der Warteschlange ab oder legt diese fest.

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

Eigenschaftswert

Eine Guid, die die Kategorie der Warteschlange (Message Queuing-Typenbezeichner) darstellt und mit der eine Anwendung ihre Warteschlangen kategorisieren kann. Der Standardwert ist Guid.empty.

Attribute

Ausnahmen

Die Kategorie der Warteschlange wurde auf einen ungültigen Wert festgelegt.

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der -Eigenschaft einer Nachrichtenwarteschlange Category abgerufen und festgelegt.

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

Die Warteschlangenkategorie ermöglicht es einer Anwendung, ihre Warteschlangen zu kategorisieren. Beispielsweise können Sie alle Abrechnungswarteschlangen in einer Kategorie und alle Order-Warteschlangen in einer anderen kategorie platzieren.

Die Category Eigenschaft bietet Zugriff auf die Eigenschaft Message Queuing Type ID (Lese-/Schreibzugriff), auf die über das Dialogfeld Warteschlangeneigenschaften in der Computerverwaltungskonsole zugegriffen werden kann. Sie können eine neue Kategorie definieren. Obwohl Sie verwenden NewGuid können, um einen Kategoriewert zu erstellen, der für alle Guid Werte eindeutig ist, ist eine solche Aktion unnötig. Der Kategoriewert darf nur von anderen Kategorien und nicht von allen anderen Guid Werten unterschieden werden. Sie können z. B. für eine Gruppe von Warteschlangen und Category als die für eine Category andere Gruppe zuweisen{00000000-0000-0000-0000-000000000001}.{00000000-0000-0000-0000-000000000002}

Es ist nicht erforderlich, die Categoryfestzulegen. Der Wert kann null sein.

Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue Instanzen von der Änderung betroffen.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und direktes Format Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Nein

Gilt für:

Weitere Informationen