Message Konstruktorok
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Inicializálja a Message osztály új példányát.
Túlterhelések
| Name | Description |
|---|---|
| Message() |
Inicializálja az Message osztály új példányát egy üres törzstel. |
| Message(Object) |
Inicializálja az Message osztály új példányát a XmlMessageFormatter megadott objektum szerializálásával az üzenet törzsébe. |
| Message(Object, IMessageFormatter) |
Inicializálja az osztály új példányát a Message megadott formázó használatával, hogy szerializálja a megadott objektumot az üzenet törzsébe. |
Message()
Inicializálja az Message osztály új példányát egy üres törzstel.
public:
Message();
public Message();
Public Sub New ()
Példák
Az alábbi példakód két különböző prioritású üzenetet küld az üzenetsorba, majd lekéri őket később.
#using <system.dll>
#using <system.messaging.dll>
using namespace System;
using namespace System::Messaging;
/// <summary>
/// Provides a container class for the example.
/// </summary>
ref class MyNewQueue
{
//**************************************************
// Sends a string message to a queue.
//**************************************************
public:
void SendMessage( MessagePriority priority, String^ messageBody )
{
// Connect to a queue on the local computer.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Create a new message.
Message^ myMessage = gcnew Message;
if ( priority > MessagePriority::Normal )
{
myMessage->Body = "High Priority: {0}",messageBody;
}
else
{
myMessage->Body = messageBody;
}
// Set the priority of the message.
myMessage->Priority = priority;
// Send the Order to the queue.
myQueue->Send( myMessage );
return;
}
//**************************************************
// Receives a message.
//**************************************************
void ReceiveMessage()
{
// Connect to the a queue on the local computer.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Set the queue to read the priority. By default, it
// is not read.
myQueue->MessageReadPropertyFilter->Priority = true;
// Set the formatter to indicate body contains a String^.
array<Type^>^ p = gcnew array<Type^>(1);
p[ 0 ] = String::typeid;
myQueue->Formatter = gcnew XmlMessageFormatter( p );
try
{
// Receive and format the message.
Message^ myMessage = myQueue->Receive();
// Display message information.
Console::WriteLine( "Priority: {0}",
myMessage->Priority );
Console::WriteLine( "Body: {0}",
myMessage->Body );
}
catch ( MessageQueueException^ )
{
// Handle Message Queuing exceptions.
}
// Handle invalid serialization format.
catch ( InvalidOperationException^ e )
{
Console::WriteLine( e->Message );
}
// Catch other exceptions as necessary.
return;
}
};
//**************************************************
// Provides an entry point into the application.
//
// This example sends and receives a message from
// a queue.
//**************************************************
int main()
{
// Create a new instance of the class.
MyNewQueue^ myNewQueue = gcnew MyNewQueue;
// Send messages to a queue.
myNewQueue->SendMessage( MessagePriority::Normal, "First Message Body." );
myNewQueue->SendMessage( MessagePriority::Highest, "Second Message Body." );
// Receive messages from a queue.
myNewQueue->ReceiveMessage();
myNewQueue->ReceiveMessage();
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 sends and receives a message from
// a queue.
//**************************************************
public static void Main()
{
// Create a new instance of the class.
MyNewQueue myNewQueue = new MyNewQueue();
// Send messages to a queue.
myNewQueue.SendMessage(MessagePriority.Normal, "First Message Body.");
myNewQueue.SendMessage(MessagePriority.Highest, "Second Message Body.");
// Receive messages from a queue.
myNewQueue.ReceiveMessage();
myNewQueue.ReceiveMessage();
return;
}
//**************************************************
// Sends a string message to a queue.
//**************************************************
public void SendMessage(MessagePriority priority, string messageBody)
{
// Connect to a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Create a new message.
Message myMessage = new Message();
if(priority > MessagePriority.Normal)
{
myMessage.Body = "High Priority: " + messageBody;
}
else
{
myMessage.Body = messageBody;
}
// Set the priority of the message.
myMessage.Priority = priority;
// Send the Order to the queue.
myQueue.Send(myMessage);
return;
}
//**************************************************
// Receives a message.
//**************************************************
public void ReceiveMessage()
{
// Connect to the a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Set the queue to read the priority. By default, it
// is not read.
myQueue.MessageReadPropertyFilter.Priority = true;
// Set the formatter to indicate body contains a string.
myQueue.Formatter = new XmlMessageFormatter(new Type[]
{typeof(string)});
try
{
// Receive and format the message.
Message myMessage = myQueue.Receive();
// Display message information.
Console.WriteLine("Priority: " +
myMessage.Priority.ToString());
Console.WriteLine("Body: " +
myMessage.Body.ToString());
}
catch (MessageQueueException)
{
// Handle Message Queuing exceptions.
}
// Handle invalid serialization format.
catch (InvalidOperationException e)
{
Console.WriteLine(e.Message);
}
// Catch other exceptions as necessary.
return;
}
}
}
Imports System.Messaging
'Provides a container class for the example.
Public Class MyNewQueue
' Provides an entry point into the application.
'
' This example sends and receives a message from
' a queue.
Public Shared Sub Main()
' Create a new instance of the class.
Dim myNewQueue As New MyNewQueue()
' Send messages to a queue.
myNewQueue.SendMessage(MessagePriority.Normal, "First Message Body.")
myNewQueue.SendMessage(MessagePriority.Highest, "Second Message Body.")
' Receive messages from a queue.
myNewQueue.ReceiveMessage()
myNewQueue.ReceiveMessage()
Return
End Sub
' Sends a string message to a queue.
Public Sub SendMessage(priority As MessagePriority, messageBody As String)
' Connect to a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
' Create a new message.
Dim myMessage As New Message()
If priority > MessagePriority.Normal Then
myMessage.Body = "High Priority: " + messageBody
Else
myMessage.Body = messageBody
End If
' Set the priority of the message.
myMessage.Priority = priority
' Send the Order to the queue.
myQueue.Send(myMessage)
Return
End Sub
' Receives a message.
Public Sub ReceiveMessage()
' Connect to the a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
' Set the queue to read the priority. By default, it
' is not read.
myQueue.MessageReadPropertyFilter.Priority = True
' Set the formatter to indicate body contains a string.
myQueue.Formatter = New XmlMessageFormatter(New Type() {GetType(String)})
Try
' Receive and format the message.
Dim myMessage As Message = myQueue.Receive()
' Display message information.
Console.WriteLine(("Priority: " + myMessage.Priority.ToString()))
Console.WriteLine(("Body: " + myMessage.Body.ToString()))
' Handle invalid serialization format.
Catch e As InvalidOperationException
Console.WriteLine(e.Message)
End Try
' Catch other exceptions as necessary.
Return
End Sub
End Class
Megjegyzések
Ezzel a túlterheléssel létrehozhat egy új példányt az Message osztályból, amelynek egy üres törzse van.
Az objektum elküldése előtt adja meg a Body tulajdonságot vagy a BodyStream tulajdonságot Message . A Body tulajdonság lehet bármilyen szerializálható objektum, például szövegsztring, struktúraobjektum, osztálypéldány vagy beágyazott objektum.
Ha nem közvetlenül a tulajdonságba BodyStream írja az üzenet tartalmát, az üzenet elküldése előtt állítsa be a Formatter tulajdonságot. A rendszer szerializálja a törzset a Formatter tulajdonság értékével a metódus példányon való Send meghívásának időpontjábanMessageQueue.
A XmlMessageFormatter rendszer lazán össze van kapcsolva, ezért a formátum használatakor nem szükséges azonos objektumtípussal rendelkeznie a feladón és a fogadón. ActiveXMessageFormatter Az BinaryMessageFormatter adatok bináris reprezentációba való szerializálása. Ez ActiveXMessageFormatter com-összetevők küldésekor vagy fogadásakor használatos.
Az alábbi táblázat a példány kezdeti tulajdonságértékét Messagemutatja be.
| Ingatlan | Kezdeti érték |
|---|---|
| AcknowledgeType | AcknowledgeType.None |
| AdministrationQueue | null |
| AppSpecific | 0 |
| AttachSenderId | true |
| AuthenticationProviderName | Microsoft Base Cryptographic Provider 1.0-s verziója |
| AuthenticationProviderType | CryptoProviderType.RSA_FULL |
| Body | null |
| BodyStream | Stream.null |
| BodyType | 0 |
| ConnectorType | Guid.Empty |
| CorrelationId | Üres sztring ("") |
| DestinationSymmetricKey | Bájtok nulla hosszúságú tömbje |
| DigitalSignature | Bájtok nulla hosszúságú tömbje |
| EncryptionAlgorithm | EncryptionAlgorithm.RC2 |
| Extension | Bájtok nulla hosszúságú tömbje |
| Formatter | XmlMessageFormatter |
| HashAlgorithm | HashAlgorithm.MD5 |
| Label | Üres sztring ("") |
| Priority | MessagePriority.Normal |
| Recoverable | false |
| ResponseQueue | null |
| SenderCertificate | Bájtok nulla hosszúságú tömbje |
| TimeToBeReceived | Message.InfiniteTimeout |
| TimeToReachQueue | Message.InfiniteTimeout |
| TransactionStatusQueue | null |
| UseAuthentication | false |
| UseDeadLetterQueue | false |
| UseEncryption | false |
| UseJournalQueue | false |
| UseTracing | false |
Lásd még
A következőre érvényes:
Message(Object)
Inicializálja az Message osztály új példányát a XmlMessageFormatter megadott objektum szerializálásával az üzenet törzsébe.
public:
Message(System::Object ^ body);
public Message(object body);
new System.Messaging.Message : obj -> System.Messaging.Message
Public Sub New (body As Object)
Paraméterek
- body
- Object
A szerializálandó objektum az üzenet törzsébe.
Példák
Az alábbi példakód egy új üzenetsort hoz létre, egy megrendelést tartalmazó üzenetet küld, majd lekéri.
#using <system.dll>
#using <system.messaging.dll>
#using <system.drawing.dll>
using namespace System;
using namespace System::Messaging;
using namespace System::Drawing;
using namespace System::IO;
ref class Order
{
public:
int orderId;
DateTime orderTime;
};
ref class MyNewQueue
{
public:
static void CreateQueue( String^ queuePath )
{
try
{
if ( !MessageQueue::Exists( queuePath ) )
{
MessageQueue::Create( queuePath );
}
else
{
Console::WriteLine( "{0} already exists.", queuePath );
}
}
catch ( MessageQueueException^ e )
{
Console::WriteLine( e->Message );
}
}
void SendMessage()
{
try
{
// Create a new order and set values.
Order^ sentOrder = gcnew Order;
sentOrder->orderId = 3;
sentOrder->orderTime = DateTime::Now;
// Connect to a queue on the local computer.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Create the new order.
Message^ myMessage = gcnew Message( sentOrder );
// Send the order to the queue.
myQueue->Send( myMessage );
}
catch ( ArgumentException^ e )
{
Console::WriteLine( e->Message );
}
return;
}
void ReceiveMessage()
{
// Connect to the a queue on the local computer.
MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
// Set the formatter to indicate body contains an Order.
array<Type^>^p = gcnew array<Type^>(1);
p[ 0 ] = Order::typeid;
myQueue->Formatter = gcnew XmlMessageFormatter( p );
try
{
// Receive and format the message.
Message^ myMessage = myQueue->Receive();
Order^ myOrder = dynamic_cast<Order^>(myMessage->Body);
// Display message information.
Console::WriteLine( "Order ID: {0}", myOrder->orderId );
Console::WriteLine( "Sent: {0}", myOrder->orderTime );
}
catch ( MessageQueueException^ )
{
// Handle Message Queuing exceptions.
}
// Handle invalid serialization format.
catch ( InvalidOperationException^ e )
{
Console::WriteLine( e->Message );
}
// Catch other exceptions as necessary.
return;
}
};
int main()
{
// Create a new instance of the class.
MyNewQueue^ myNewQueue = gcnew MyNewQueue;
// Create a queue on the local computer.
MyNewQueue::CreateQueue( ".\\myQueue" );
// Send a message to a queue.
myNewQueue->SendMessage();
// Receive a message from a queue.
myNewQueue->ReceiveMessage();
return 0;
}
using System;
using System.Messaging;
using System.Drawing;
using System.IO;
namespace MyProject
{
// The following example
// sends to a queue and receives from a queue.
public class Order
{
public int orderId;
public DateTime orderTime;
};
/// <summary>
/// Provides a container class for the example.
/// </summary>
public class MyNewQueue
{
//**************************************************
// Provides an entry point into the application.
//
// This example sends and receives a message from
// a queue.
//**************************************************
public static void Main()
{
// Create a new instance of the class.
MyNewQueue myNewQueue = new MyNewQueue();
// Create a queue on the local computer.
CreateQueue(".\\myQueue");
// Send a message to a queue.
myNewQueue.SendMessage();
// Receive a message from a queue.
myNewQueue.ReceiveMessage();
return;
}
//**************************************************
// Creates a new queue.
//**************************************************
public static void CreateQueue(string queuePath)
{
try
{
if(!MessageQueue.Exists(queuePath))
{
MessageQueue.Create(queuePath);
}
else
{
Console.WriteLine(queuePath + " already exists.");
}
}
catch (MessageQueueException e)
{
Console.WriteLine(e.Message);
}
}
//**************************************************
// Sends an Order to a queue.
//**************************************************
public void SendMessage()
{
try
{
// Create a new order and set values.
Order sentOrder = new Order();
sentOrder.orderId = 3;
sentOrder.orderTime = DateTime.Now;
// Connect to a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Create the new order.
Message myMessage = new Message(sentOrder);
// Send the order to the queue.
myQueue.Send(myMessage);
}
catch(ArgumentException e)
{
Console.WriteLine(e.Message);
}
return;
}
//**************************************************
// Receives a message containing an order.
//**************************************************
public void ReceiveMessage()
{
// Connect to the a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Set the formatter to indicate body contains an Order.
myQueue.Formatter = new XmlMessageFormatter(new Type[]
{typeof(MyProject.Order)});
try
{
// Receive and format the message.
Message myMessage = myQueue.Receive();
Order myOrder = (Order)myMessage.Body;
// Display message information.
Console.WriteLine("Order ID: " +
myOrder.orderId.ToString());
Console.WriteLine("Sent: " +
myOrder.orderTime.ToString());
}
catch (MessageQueueException)
{
// Handle Message Queuing exceptions.
}
// Handle invalid serialization format.
catch (InvalidOperationException e)
{
Console.WriteLine(e.Message);
}
// Catch other exceptions as necessary.
return;
}
}
}
Imports System.Messaging
Imports System.Drawing
Imports System.IO
' The following example
' sends to a queue and receives from a queue.
Public Class Order
Public orderId As Integer
Public orderTime As DateTime
End Class
' Provides a container class for the example.
Public Class MyNewQueue
' Provides an entry point into the application.
'
' This example sends and receives a message from
' a queue.
Public Shared Sub Main()
' Create a new instance of the class.
Dim myNewQueue As New MyNewQueue()
' Create a queue on the local computer.
CreateQueue(".\myQueue")
' Send a message to a queue.
myNewQueue.SendMessage()
' Receive a message from a queue.
myNewQueue.ReceiveMessage()
Return
End Sub
' Creates a new queue.
Public Shared Sub CreateQueue(queuePath As String)
Try
If Not MessageQueue.Exists(queuePath) Then
MessageQueue.Create(queuePath)
Else
Console.WriteLine((queuePath + " already exists."))
End If
Catch e As MessageQueueException
Console.WriteLine(e.Message)
End Try
End Sub
' Sends an Order to a queue.
Public Sub SendMessage()
Try
' Create a new order and set values.
Dim sentOrder As New Order()
sentOrder.orderId = 3
sentOrder.orderTime = DateTime.Now
' Connect to a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
' Create the new order.
Dim myMessage As New Message(sentOrder)
' Send the order to the queue.
myQueue.Send(myMessage)
Catch e As ArgumentException
Console.WriteLine(e.Message)
End Try
Return
End Sub
' Receives a message containing an order.
Public Sub ReceiveMessage()
' Connect to the a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
' Set the formatter to indicate body contains an Order.
myQueue.Formatter = New XmlMessageFormatter(New Type() {GetType(Order)})
Try
' Receive and format the message.
Dim myMessage As Message = myQueue.Receive()
Dim myOrder As Order = CType(myMessage.Body, Order)
' Display message information.
Console.WriteLine(("Order ID: " + myOrder.orderId.ToString()))
Console.WriteLine(("Sent: " + myOrder.orderTime.ToString()))
' Handle invalid serialization format.
Catch e As InvalidOperationException
Console.WriteLine(e.Message)
End Try
' Catch other exceptions as necessary.
Return
End Sub
End Class
Megjegyzések
Ezzel a túlterheléssel hozzon létre egy új példányt az Message osztályból, amely a Body paraméter által body megadott értéket tartalmazza. A body paraméter bármilyen szerializálható objektum lehet, például szöveges sztring, struktúraobjektum, osztálypéldány vagy beágyazott objektum. A rendszer szerializálja a törzset, XmlMessageFormatter hacsak nem módosítja a Formatter tulajdonságot az Message elküldés előtt. Ha a hívás Bodyelőtt bármikor módosítja a FormatterSend tulajdonságot, az üzenet az új tulajdonságérték szerint lesz szerializálva.
A XmlMessageFormatter rendszer lazán össze van kapcsolva, ezért a formátum használatakor nem szükséges azonos objektumtípussal rendelkeznie a feladón és a fogadón. ActiveXMessageFormatter Az BinaryMessageFormatter adatok bináris reprezentációba való szerializálása. Ez ActiveXMessageFormatter com-összetevők küldésekor vagy fogadásakor használatos.
Az alábbi táblázat a példány kezdeti tulajdonságértékét Messagemutatja be.
| Ingatlan | Kezdeti érték |
|---|---|
| AcknowledgeType | AcknowledgeType.None |
| AdministrationQueue | null |
| AppSpecific | 0 |
| AttachSenderId | true |
| AuthenticationProviderName | Microsoft Base Cryptographic Provider 1.0-s verziója |
| AuthenticationProviderType | CryptoProviderType.RSA_FULL |
| Body | A body paraméter. |
| BodyStream | Stream.null |
| BodyType | 0 |
| ConnectorType | Guid.Empty |
| CorrelationId | Üres sztring ("") |
| DestinationSymmetricKey | Bájtok nulla hosszúságú tömbje |
| DigitalSignature | Bájtok nulla hosszúságú tömbje |
| EncryptionAlgorithm | EncryptionAlgorithm.RC2 |
| Extension | Bájtok nulla hosszúságú tömbje |
| Formatter | XmlMessageFormatter |
| HashAlgorithm | HashAlgorithm.MD5 |
| Label | Üres sztring ("") |
| Priority | MessagePriority.Normal |
| Recoverable | false |
| ResponseQueue | null |
| SenderCertificate | Bájtok nulla hosszúságú tömbje |
| TimeToBeReceived | Message.InfiniteTimeout |
| TimeToReachQueue | Message.InfiniteTimeout |
| TransactionStatusQueue | null |
| UseAuthentication | false |
| UseDeadLetterQueue | false |
| UseEncryption | false |
| UseJournalQueue | false |
| UseTracing | false |
Lásd még
A következőre érvényes:
Message(Object, IMessageFormatter)
Inicializálja az osztály új példányát a Message megadott formázó használatával, hogy szerializálja a megadott objektumot az üzenet törzsébe.
public:
Message(System::Object ^ body, System::Messaging::IMessageFormatter ^ formatter);
public Message(object body, System.Messaging.IMessageFormatter formatter);
new System.Messaging.Message : obj * System.Messaging.IMessageFormatter -> System.Messaging.Message
Public Sub New (body As Object, formatter As IMessageFormatter)
Paraméterek
- body
- Object
A szerializálandó objektum az üzenet törzsébe.
- formatter
- IMessageFormatter
Az IMessageFormatter üzenet törzsének szerializálására szolgáló formázót adja meg.
Példák
using System;
using System.Messaging;
using System.Drawing;
using System.IO;
namespace MyProject
{
/// <summary>
/// Provides a container class for the example.
/// </summary>
public class MyNewQueue
{
//**************************************************
// Provides an entry point into the application.
//
// This example sends and receives a message from
// a queue.
//**************************************************
public static void Main()
{
// Create a new instance of the class.
MyNewQueue myNewQueue = new MyNewQueue();
// Create a queue on the local computer.
CreateQueue(".\\myQueue");
// Send a message to a queue.
myNewQueue.SendMessage();
// Receive a message from a queue.
myNewQueue.ReceiveMessage();
return;
}
//**************************************************
// Creates a new queue.
//**************************************************
public static void CreateQueue(string queuePath)
{
try
{
if(!MessageQueue.Exists(queuePath))
{
MessageQueue.Create(queuePath);
}
else
{
Console.WriteLine(queuePath + " already exists.");
}
}
catch (MessageQueueException e)
{
Console.WriteLine(e.Message);
}
}
//**************************************************
// Sends an image to a queue, using the BinaryMessageFormatter.
//**************************************************
public void SendMessage()
{
try{
// Create a new bitmap.
// The file must be in the \bin\debug or \bin\retail folder, or
// you must give a full path to its location.
Image myImage = Bitmap.FromFile("SentImage.bmp");
// Connect to a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
Message myMessage = new Message(myImage, new BinaryMessageFormatter());
// Send the image to the queue.
myQueue.Send(myMessage);
}
catch(ArgumentException e)
{
Console.WriteLine(e.Message);
}
return;
}
//**************************************************
// Receives a message containing an image.
//**************************************************
public void ReceiveMessage()
{
try
{
// Connect to the a queue on the local computer.
MessageQueue myQueue = new MessageQueue(".\\myQueue");
// Set the formatter to indicate body contains an Order.
myQueue.Formatter = new BinaryMessageFormatter();
// Receive and format the message.
System.Messaging.Message myMessage = myQueue.Receive();
Bitmap myImage = (Bitmap)myMessage.Body;
// This will be saved in the \bin\debug or \bin\retail folder.
myImage.Save("ReceivedImage.bmp",System.Drawing.Imaging.ImageFormat.Bmp);
}
catch (MessageQueueException)
{
// Handle Message Queuing exceptions.
}
// Handle invalid serialization format.
catch (InvalidOperationException e)
{
Console.WriteLine(e.Message);
}
catch (IOException e)
{
// Handle file access exceptions.
}
// Catch other exceptions as necessary.
return;
}
}
}
Imports System.Messaging
Imports System.Drawing
Imports System.IO
Namespace MyProj
_
Public Class MyNewQueue
'**************************************************
' Provides an entry point into the application.
'
' This example sends and receives a message from
' a queue.
'**************************************************
Public Shared Sub Main()
' Create a new instance of the class.
Dim myNewQueue As New MyNewQueue()
' Create a queue on the local computer.
CreateQueue(".\myQueue")
' Send a message to a queue.
myNewQueue.SendMessage()
' Receive a message from a queue.
myNewQueue.ReceiveMessage()
Return
End Sub
'**************************************************
' Creates a new queue.
'**************************************************
Public Shared Sub CreateQueue(queuePath As String)
Try
If Not MessageQueue.Exists(queuePath) Then
MessageQueue.Create(queuePath)
Else
Console.WriteLine((queuePath + " already exists."))
End If
Catch e As MessageQueueException
Console.WriteLine(e.Message)
End Try
End Sub
'**************************************************
' Sends an image to a queue, using the BinaryMessageFormatter.
'**************************************************
Public Sub SendMessage()
Try
' Create a new bitmap.
' The file must be in the \bin\debug or \bin\retail folder, or
' you must give a full path to its location.
Dim myImage As Image = Bitmap.FromFile("SentImage.bmp")
' Connect to a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
Dim myMessage As New Message(myImage, New BinaryMessageFormatter())
' Send the image to the queue.
myQueue.Send(myMessage)
Catch e As ArgumentException
Console.WriteLine(e.Message)
End Try
Return
End Sub
'**************************************************
' Receives a message containing an image.
'**************************************************
Public Sub ReceiveMessage()
Try
' Connect to the a queue on the local computer.
Dim myQueue As New MessageQueue(".\myQueue")
' Set the formatter to indicate body contains an Order.
myQueue.Formatter = New BinaryMessageFormatter()
' Receive and format the message.
Dim myMessage As System.Messaging.Message = myQueue.Receive()
Dim myImage As Bitmap = CType(myMessage.Body, Bitmap)
' This will be saved in the \bin\debug or \bin\retail folder.
myImage.Save("ReceivedImage.bmp", System.Drawing.Imaging.ImageFormat.Bmp)
'Catch
' Handle Message Queuing exceptions.
' Handle invalid serialization format.
Catch e As InvalidOperationException
Console.WriteLine(e.Message)
Catch e As IOException
End Try
' Handle file access exceptions.
' Catch other exceptions as necessary.
Return
End Sub
End Class
End Namespace 'MyProj
Megjegyzések
Ezzel a túlterheléssel hozzon létre egy új példányt az Message osztályból, amely a Body paraméter által body megadott értéket tartalmazza, és amely bármely érvényes formázó használatával szerializálja a törzset. A body paraméter bármilyen szerializálható objektum, például szöveges sztring, struktúraobjektum, osztálypéldány vagy beágyazott objektum. Ha a hívás Bodyelőtt bármikor módosítja a FormatterSend tulajdonságot, az üzenet az új tulajdonságérték szerint lesz szerializálva.
A XmlMessageFormatter rendszer lazán össze van kapcsolva, ezért a formátum használatakor nem szükséges azonos objektumtípussal rendelkeznie a feladón és a fogadón. ActiveXMessageFormatter Az BinaryMessageFormatter adatok bináris reprezentációba való szerializálása. Ez ActiveXMessageFormatter com-összetevők küldésekor vagy fogadásakor használatos.
Az alábbi táblázat a példány kezdeti tulajdonságértékét Messagemutatja be.
| Ingatlan | Kezdeti érték |
|---|---|
| AcknowledgeType | AcknowledgeType.None |
| AdministrationQueue | null |
| AppSpecific | 0 |
| AttachSenderId | true |
| AuthenticationProviderName | Microsoft Base Cryptographic Provider 1.0-s verziója |
| AuthenticationProviderType | CryptoProviderType.RSA_FULL |
| Body | A body paraméter. |
| BodyStream | Stream.null |
| BodyType | 0 |
| ConnectorType | Guid.Empty |
| CorrelationId | Üres sztring ("") |
| DestinationSymmetricKey | Bájtok nulla hosszúságú tömbje |
| DigitalSignature | Bájtok nulla hosszúságú tömbje |
| EncryptionAlgorithm | EncryptionAlgorithm.RC2 |
| Extension | Bájtok nulla hosszúságú tömbje |
| Formatter | A formatter paraméter. |
| HashAlgorithm | HashAlgorithm.MD5 |
| Label | Üres sztring ("") |
| Priority | MessagePriority.Normal |
| Recoverable | false |
| ResponseQueue | null |
| SenderCertificate | Bájtok nulla hosszúságú tömbje |
| TimeToBeReceived | Message.InfiniteTimeout |
| TimeToReachQueue | Message.InfiniteTimeout |
| TransactionStatusQueue | null |
| UseAuthentication | false |
| UseDeadLetterQueue | false |
| UseEncryption | false |
| UseJournalQueue | false |
| UseTracing | false |
Lásd még
- XmlMessageFormatter
- BinaryMessageFormatter
- ActiveXMessageFormatter
- DefaultPropertiesToSend
- MessageQueue
- Send(Object)
- Peek()
- Receive()