Export (0) Print
Expand All

MessagePropertyFilter.ConnectorType Property

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

Namespace:  System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

[MessagingDescriptionAttribute("MsgConnectorType")]
public bool ConnectorType { get; set; }

Property Value

Type: System.Boolean
true to receive Message.ConnectorType information; otherwise, false. The default is false.

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.

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);

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft