MessageQueue.Category Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Guid

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: MessagingDescriptionAttribute

Ausnahmen

ArgumentException

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

MessageQueueException

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: