MessageQueue.Category-Eigenschaft
Ruft die Kategorie der Warteschlange ab oder legt diese fest.
Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)
Syntax
'Declaration
Public Property Category As Guid
'Usage
Dim instance As MessageQueue
Dim value As Guid
value = instance.Category
instance.Category = value
public Guid Category { get; set; }
public:
property Guid Category {
Guid get ();
void set (Guid value);
}
/** @property */
public Guid get_Category ()
/** @property */
public void set_Category (Guid value)
public function get Category () : Guid
public function set Category (value : Guid)
Eigenschaftenwert
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.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die Kategorie der Warteschlange wurde auf einen ungültigen Wert festgelegt. |
|
Fehler beim Zugriff auf eine Message Queuing-Methode. |
Hinweise
Die Kategorie der Warteschlange ermöglicht es einer Anwendung, ihre Warteschlangen zu kategorisieren. So können beispielsweise einer Kategorie alle Warteschlangen für Rechnungen und einer anderen Kategorie alle Warteschlangen für Aufträge zugeordnet werden.
Die Category-Eigenschaft ermöglicht den Zugriff auf die Typ-ID-Eigenschaft von Message Queuing (Lese-/Schreibzugriff), die in der Konsole Computerverwaltung im Dialogfeld Eigenschaften von Warteschlange angezeigt wird. Sie können eine neue Kategorie definieren. Sie können mithilfe von NewGuid einen unter allen Guid-Werten eindeutigen neuen Kategoriewert erstellen, dies ist jedoch nicht erforderlich. Der Kategoriewert muss nur für andere Kategorien und nicht unter allen Guid-Werten eindeutig sein. Sie können beispielsweise {00000000-0000-0000-0000-000000000001} als Category für eine Gruppe von Warteschlangen und {00000000-0000-0000-0000-000000000002} als Category für eine andere Gruppe zuweisen.
Die Category muss nicht festgelegt werden. Der Wert kann NULL (Nothing in Visual Basic) sein.
Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue-Instanzen ebenfalls von dieser Änderung betroffen.
Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.
Arbeitsgruppenmodus |
Verfügbar |
|---|---|
Lokaler Computer |
Ja |
Lokaler Computer + direkter Formatname |
Ja |
Remotecomputer |
Nein |
Lokaler Computer + direkter Formatname |
Nein |
Beispiel
Im folgenden Codebeispiel wird der Wert der Category-Eigenschaft einer Meldungswarteschlange 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);
// Set the queue's Category property value.
queue.set_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.get_Category());
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
Id
Label
GetPublicQueues