DefaultPropertiesToSend Klasse
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.
Gibt die Standardwerte für Eigenschaften an, die beim Senden von Objekten (mit Ausnahme von Message-Instanzen) an eine Meldungswarteschlange verwendet werden.
public ref class DefaultPropertiesToSend[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public class DefaultPropertiesToSend[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type DefaultPropertiesToSend = classPublic Class DefaultPropertiesToSend- Vererbung
-
DefaultPropertiesToSend
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Priorität einer Nachricht verwendet, um die Standardeigenschaften zu bestimmen, die für die Nachricht gesendet werden sollen.
#using <system.dll>
#using <system.messaging.dll>
using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:
// Associates selected message property values
// with high priority messages.
void SendHighPriorityMessages()
{
// Connect to a message queue.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Associate selected default property values with high
// priority messages.
myQueue->DefaultPropertiesToSend->Priority = MessagePriority::High;
myQueue->DefaultPropertiesToSend->Label = "High Priority Message";
myQueue->DefaultPropertiesToSend->Recoverable = true;
myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,0,30);
// Send messages using these defaults.
myQueue->Send( "High priority message data 1." );
myQueue->Send( "High priority message data 2." );
myQueue->Send( "High priority message data 3." );
return;
}
// Associates selected message property values
// with normal priority messages.
void SendNormalPriorityMessages()
{
// Connect to a message queue.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Associate selected default property values with normal
// priority messages.
myQueue->DefaultPropertiesToSend->Priority = MessagePriority::Normal;
myQueue->DefaultPropertiesToSend->Label = "Normal Priority Message";
myQueue->DefaultPropertiesToSend->Recoverable = false;
myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,2,0);
// Send messages using these defaults.
myQueue->Send( "Normal priority message data 1." );
myQueue->Send( "Normal priority message data 2." );
myQueue->Send( "Normal priority message data 3." );
return;
}
};
// Provides an entry point into the application.
// This example specifies different types of default
// properties for messages.
int main()
{
// Create a new instance of the class.
MyNewQueue^ myNewQueue = gcnew MyNewQueue;
// Send normal and high priority messages.
myNewQueue->SendNormalPriorityMessages();
myNewQueue->SendHighPriorityMessages();
return 0;
}
using System;
using System.Messaging;
namespace MyProject
{
/// <summary>
/// Provides a container class for the example.
/// </summary>
public class MyNewQueue
{
//**************************************************
// Provides an entry point into the application.
//
// This example specifies different types of default
// properties for messages.
//**************************************************
public static void Main()
{
// Create a new instance of the class.
MyNewQueue myNewQueue = new MyNewQueue();
// Send normal and high priority messages.
myNewQueue.SendNormalPriorityMessages();
myNewQueue.SendHighPriorityMessages();
return;
}
//**************************************************
// Associates selected message property values
// with high priority messages.
//**************************************************
public void SendHighPriorityMessages()
{
// Connect to a message queue.
MessageQueue myQueue = new
MessageQueue(".\\myQueue");
// Associate selected default property values with high
// priority messages.
myQueue.DefaultPropertiesToSend.Priority =
MessagePriority.High;
myQueue.DefaultPropertiesToSend.Label =
"High Priority Message";
myQueue.DefaultPropertiesToSend.Recoverable = true;
myQueue.DefaultPropertiesToSend.TimeToReachQueue =
new TimeSpan(0,0,30);
// Send messages using these defaults.
myQueue.Send("High priority message data 1.");
myQueue.Send("High priority message data 2.");
myQueue.Send("High priority message data 3.");
return;
}
//**************************************************
// Associates selected message property values
// with normal priority messages.
//**************************************************
public void SendNormalPriorityMessages()
{
// Connect to a message queue.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Associate selected default property values with normal
// priority messages.
myQueue.DefaultPropertiesToSend.Priority =
MessagePriority.Normal;
myQueue.DefaultPropertiesToSend.Label =
"Normal Priority Message";
myQueue.DefaultPropertiesToSend.Recoverable = false;
myQueue.DefaultPropertiesToSend.TimeToReachQueue =
new TimeSpan(0,2,0);
// Send messages using these defaults.
myQueue.Send("Normal priority message data 1.");
myQueue.Send("Normal priority message data 2.");
myQueue.Send("Normal priority message data 3.");
return;
}
}
}
Imports System.Messaging
Public Class MyNewQueue
' Provides an entry point into the application.
'
' This example specifies different types of default
' properties for messages.
Public Shared Sub Main()
' Create a new instance of the class.
Dim myNewQueue As New MyNewQueue()
' Send normal and high priority messages.
myNewQueue.SendNormalPriorityMessages()
myNewQueue.SendHighPriorityMessages()
Return
End Sub
' Associates selected message property values
' with high priority messages.
Public Sub SendHighPriorityMessages()
' Connect to a message queue.
Dim myQueue As New MessageQueue(".\myQueue")
' Associate selected default property values with high
' priority messages.
myQueue.DefaultPropertiesToSend.Priority = _
MessagePriority.High
myQueue.DefaultPropertiesToSend.Label = _
"High Priority Message"
myQueue.DefaultPropertiesToSend.Recoverable = True
myQueue.DefaultPropertiesToSend.TimeToReachQueue = _
New TimeSpan(0, 0, 30)
' Send messages using these defaults.
myQueue.Send("High priority message data 1.")
myQueue.Send("High priority message data 2.")
myQueue.Send("High priority message data 3.")
Return
End Sub
' Associates selected message property values
' with normal priority messages.
Public Sub SendNormalPriorityMessages()
' Connect to a message queue.
Dim myQueue As New MessageQueue(".\myQueue")
' Associate selected default property values with normal
' priority messages.
myQueue.DefaultPropertiesToSend.Priority = _
MessagePriority.Normal
myQueue.DefaultPropertiesToSend.Label = _
"Normal Priority Message"
myQueue.DefaultPropertiesToSend.Recoverable = False
myQueue.DefaultPropertiesToSend.TimeToReachQueue = _
New TimeSpan(0, 2, 0)
' Send messages using these defaults.
myQueue.Send("Normal priority message data 1.")
myQueue.Send("Normal priority message data 2.")
myQueue.Send("Normal priority message data 3.")
Return
End Sub
End Class
Hinweise
Sie können Standardwerte für ausgewählte Eigenschaften für Nachrichten festlegen, die an eine MessageQueuegesendet werden. DefaultPropertiesToSend wird verwendet, um Standardeigenschaftswerte der Nachricht anzugeben, die gesendet wird, wenn andere Objekte als Message Instanzen an eine Warteschlange gesendet werden, z. B. das Zeichenfolgenargument, das an die Send -Methode im Codefragment myMessageQueue.Send("hello")übergeben wird. Die Message -Klasse verfügt über entsprechende, identisch benannte Eigenschaften wie diejenigen inDefaultPropertiesToSend, die die Werte bereitstellen, wenn eine Message instance speziell gesendet wird. Selbst wenn Sie für eine Warteschlange angegeben MessageQueue.DefaultPropertiesToSend haben, führt das Senden eines Message Objekts an diese Warteschlange dazu, dass die Werte für die identisch benannten Message Eigenschaften die Werte der Warteschlange DefaultPropertiesToSend überschreiben.
Eigenschaften, die Sie nicht explizit festlegen, werden standardmäßig auf die werte festgelegt, DefaultPropertiesToSenddie vom Konstruktor angegeben werden.
Eine Liste der anfänglichen Eigenschaftswerte für eine instance von DefaultPropertiesToSendfinden Sie im DefaultPropertiesToSend Konstruktor.
Konstruktoren
| DefaultPropertiesToSend() |
Initialisiert eine neue Instanz der DefaultPropertiesToSend-Klasse. |
Eigenschaften
| AcknowledgeType |
Ruft den Typ der Bestätigungsmeldung ab, die an die sendende Anwendung zurückgegeben werden soll, oder legt diesen fest. |
| AdministrationQueue |
Ruft die Warteschlange ab, die die von Message Queuing generierten Bestätigungsmeldungen empfängt, oder legt diese fest. |
| AppSpecific |
Ruft zusätzliche anwendungsspezifische Daten ab oder legt diese fest. |
| AttachSenderId |
Ruft einen Wert ab, der angibt, ob die Sender-ID an die Meldung angehängt werden soll, oder legt diesen fest. |
| EncryptionAlgorithm |
Ruft den Verschlüsselungsalgorithmus ab, der zum Verschlüsseln des Meldungstextes einer privaten Meldung verwendet wird, oder legt diesen fest. |
| Extension |
Ruft zusätzliche Daten ab, die der Meldung zugeordnet sind, oder legt diese fest. |
| HashAlgorithm |
Ruft den beim Authentifizieren von Meldungen oder Erzeugen einer digitalen Signatur für eine Meldung verwendeten Hashalgorithmus ab oder legt diesen fest. |
| Label |
Ruft eine von der Anwendung definierte Zeichenfolge ab, die die Meldung beschreibt, oder legt diese fest. |
| Priority |
Ruft die Meldungspriorität ab, mit der die Position der Meldung in der Warteschlange bestimmt, oder legt diese fest. |
| Recoverable |
Ruft einen Wert ab, der angibt, ob die Zustellung einer Meldung im Falle eines Computerfehlers oder Netzwerkproblems sichergestellt ist, oder legt diesen fest. |
| ResponseQueue |
Ruft die Warteschlange ab, die von einer Anwendung generierte Antwortnachrichten empfängt, oder legt diese fest. |
| TimeToBeReceived |
Ruft die Zeitbegrenzung für das Abrufen der Meldung aus der Zielwarteschlange ab oder legt diese fest. |
| TimeToReachQueue |
Ruft die Zeitbegrenzung der Meldung für das Erreichen der Warteschlange ab oder legt diese fest. |
| TransactionStatusQueue |
Ruft die Transaktionsstatus-Warteschlange auf dem Quellcomputer ab. |
| UseAuthentication |
Ruft einen Wert ab, der angibt, ob die Meldung vor dem Senden authentifiziert werden muss, oder legt diesen fest. |
| UseDeadLetterQueue |
Ruft einen Wert ab, der angibt, ob eine Kopie der nicht zustellbaren Meldung an eine Dead Letter-Warteschlange gesendet werden soll, oder legt diesen fest. |
| UseEncryption |
Ruft einen Wert ab, der angibt, ob die Meldung als privat behandelt werden soll, oder legt diesen fest. |
| UseJournalQueue |
Ruft einen Wert ab, der angibt, ob eine Kopie der Meldung in einem Journal auf dem sendenden Computer abgelegt werden soll, oder legt diesen fest. |
| UseTracing |
Ruft einen Wert ab, der angibt, ob eine Meldung während der Weiterleitung an die Zielwarteschlange verfolgt wird, oder legt diesen fest. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
