Edit

MessagePropertyFilter.ConnectorType Property

  • Reference

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Gets or sets a value that indicates whether to retrieve ConnectorType property information when receiving or peeking a message.

public:
 property bool ConnectorType { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgConnectorType")]
public bool ConnectorType { get; set; }
[<System.Messaging.MessagingDescription("MsgConnectorType")>]
member this.ConnectorType : bool with get, set
Public Property ConnectorType As Boolean

Property Value

Boolean

true to receive ConnectorType information; otherwise, false. The default is false.

Attributes
MessagingDescriptionAttribute

Examples

The following code example demonstrates the use of the ConnectorType property.

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's ConnectorType property.
queue->MessageReadPropertyFilter->ConnectorType = true;

// Peek at the message. Time out after ten seconds 
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));

// Display the value of the message's 
// ConnectorType property.
Console::WriteLine("Message.ConnectorType: {0}", 
    orderMessage->ConnectorType);

// Set the queue's MessageReadPropertyFilter property to enable the
// message's ConnectorType property.
queue.MessageReadPropertyFilter.ConnectorType = true;

// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));

// Display the value of the message's ConnectorType property.
Console.WriteLine("Message.ConnectorType: {0}",
    orderMessage.ConnectorType);

Remarks

The ConnectorType property of the Message class is required when an application sets a message property that is typically set by Message Queuing. It is used in the following two instances:

  • When a message is passed by a connector application, the Message.ConnectorType is required for the sending and receiving applications to interpret the security and acknowledgment properties of the message.

  • When sending application-encrypted messages, the Message.ConnectorType property informs Message Queuing to use the symmetric key.

Applies to

See also