PrefixEndpointAddressMessageFilter Class

Reference

Definition

Namespace:: System.ServiceModel.Dispatcher

Assembly:: System.ServiceModel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Represents a query that tests whether a message matches an EndpointAddress using a Longest-Prefix Match for the URI component.

public ref class PrefixEndpointAddressMessageFilter : System::ServiceModel::Dispatcher::MessageFilter

public class PrefixEndpointAddressMessageFilter : System.ServiceModel.Dispatcher.MessageFilter

type PrefixEndpointAddressMessageFilter = class
    inherit MessageFilter

Public Class PrefixEndpointAddressMessageFilter
Inherits MessageFilter

Inheritance: Object

MessageFilter
PrefixEndpointAddressMessageFilter

Remarks

An EndpointAddress object includes a URI and an optional collection of addressing headers. The addressing and message headers are canonicalized to be compared for equality. If a parameter appears more than once in an EndpointAddress, the corresponding header must appear in the message at least that many times.

This filter performs the same query as EndpointAddressMessageFilter, except that the test for whether a message matches an endpoint address is done by a Longest-Prefix Match. This means that the URI specified in the filter does not have to match the message's URI exactly, but must be contained in that URI as a prefix. For example, if a filter specifies the address "www.foo.com", and a message is addressed to "www.foo.com/customerA", then the URI part of the filter query condition will be met. However, the header portion of the filter query still has to be done.

Internet Information Services (IIS) and the underlying file system (NTFS or FAT) are case-insensitive. URI comparisons done by this class are also case-insensitive. So, for example, http://www.microsoft.com is evaluated as equal to http://WWW.microsoft.com.

Constructors

PrefixEndpointAddressMessageFilter(EndpointAddress)	Initializes a new instance of the PrefixEndpointAddressMessageFilter class.
PrefixEndpointAddressMessageFilter(EndpointAddress, Boolean)	Initializes a new instance of the PrefixEndpointAddressMessageFilter class.

Properties

Address	Gets the Endpoint Address that the PrefixEndpointAddressMessageFilter tests messages against.
IncludeHostNameInComparison	Gets a value that indicates whether the host name is included in the endpoint address comparison.

Methods

CreateFilterTable<FilterData>()	Creates a new filter table that tests a message against multiple endpoint addresses simultaneously.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
Match(Message)	Tests whether a message satisfies the specified endpoint address.
Match(MessageBuffer)	Tests whether a buffered message satisfies the specified endpoint address.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to