MessageQueue.Category Eigenschaft
Definition
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 Warteschlangenkategorie ab oder legt sie 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, setPublic Property Category As GuidEigenschaftswert
A Guid that represents the queue category (Message Queuing type identifier), which allow an application to kategorisier its queues. Der Standardwert lautet Guid.empty.
- Attribute
Ausnahmen
Die Warteschlangenkategorie 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, die zugehörigen Warteschlangen zu kategorisieren. Sie können beispielsweise alle Abrechnungswarteschlangen in einer Kategorie und alle Bestellwarteschlangen 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 einen NewGuid Kategoriewert erstellen können, der für alle Guid Werte eindeutig ist, ist eine solche Aktion unnötig. Der Kategoriewert muss nur von anderen Kategorien und nicht von allen anderen Guid Werten unterschieden werden. Sie können z. B. als Category eine Gruppe von Warteschlangen und {00000000-0000-0000-0000-000000000002} als Category einen anderen Satz zuweisen{00000000-0000-0000-0000-000000000001}.
Es ist nicht erforderlich, die Category. Der Wert kann sein null.
Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue Instanzen von der Änderung betroffen.
In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokaler Computer | Ja |
| Name des lokalen Computers und des direkten Formats | Ja |
| Remotecomputer | No |
| Name des Remotecomputers und des direkten Formats | No |
