MessageQueue.BasePriority-Eigenschaft
Gibt die Basispriorität an, die von Message Queuing beim Weiterleiten von Meldungen einer öffentlichen Warteschlange über das Netzwerk verwendet wird, oder legt diese fest.
Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)
Syntax
'Declaration
Public Property BasePriority As Short
'Usage
Dim instance As MessageQueue
Dim value As Short
value = instance.BasePriority
instance.BasePriority = value
public short BasePriority { get; set; }
public:
property short BasePriority {
short get ();
void set (short value);
}
/** @property */
public short get_BasePriority ()
/** @property */
public void set_BasePriority (short value)
public function get BasePriority () : short
public function set BasePriority (value : short)
Eigenschaftenwert
Die gemeinsame Basispriorität für alle an die (öffentliche) Warteschlange gesendeten Meldungen. Der Standardwert ist null (0).
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die Basispriorität wurde auf einen ungültigen Wert festgelegt. |
|
Fehler beim Zugriff auf eine Message Queuing-Methode. |
Hinweise
Die Priorität einer Warteschlange legt fest, wie eine Meldung während der Übertragung zur Warteschlange im Netzwerk behandelt wird. Sie können die BasePriority-Eigenschaft so festlegen, dass Meldungen für diese Warteschlange beim Senden eine höhere oder niedrigere Priorität als Meldungen für andere Warteschlangen zugewiesen wird. Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue-Instanzen ebenfalls von dieser Änderung betroffen.
Die BasePriority-Eigenschaft einer Warteschlange steht nicht im Bezug zur Priority-Eigenschaft einer Meldung. Letztere legt die Reihenfolge fest, in der eingehende Meldungen in eine Warteschlange gestellt werden.
Die BasePriority kann nur für öffentliche Wartschlangen festgelegt werden, deren Pfad anhand des Formatnamens angegeben wurde. Die Basispriorität einer privaten Warteschlange ist immer null (0).
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 BasePriority-Eigenschaft einer Meldungswarteschlange abgerufen und festgelegt.
// Set the queue's BasePriority property value.
queue.BasePriority = 10;
// Display the new value of the queue's BasePriority property.
Console.WriteLine("MessageQueue.BasePriority: {0}", queue.BasePriority);
// Set the queue's BasePriority property value.
queue.set_BasePriority((short)10);
// Display the new value of the queue's BasePriority property.
Console.WriteLine("MessageQueue.BasePriority: {0}",
System.Convert.ToString(queue.get_BasePriority()));
.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
FormatName