PrefixEndpointAddressMessageFilter Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

Namespace:   System.ServiceModel.Dispatcher
Assembly:  System.ServiceModel (in System.ServiceModel.dll)


public class PrefixEndpointAddressMessageFilter : MessageFilter


Initializes a new instance of the PrefixEndpointAddressMessageFilter class.

System_CAPS_pubmethodPrefixEndpointAddressMessageFilter(EndpointAddress, Boolean)

Initializes a new instance of the PrefixEndpointAddressMessageFilter class.


Gets the Endpoint Address that the PrefixEndpointAddressMessageFilter tests messages against.


Gets a value that indicates whether the host name is included in the endpoint address comparison.


Creates a new filter table that tests a message against multiple endpoint addresses simultaneously.(Overrides MessageFilter.CreateFilterTable<FilterData>().)


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Tests whether a message satisfies the specified endpoint address.(Overrides MessageFilter.Match(Message).)


Tests whether a buffered message satisfies the specified endpoint address.(Overrides MessageFilter.Match(MessageBuffer).)


Creates a shallow copy of the current Object.(Inherited from Object.)


Returns a string that represents the current object.(Inherited from Object.)

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 "", and a message is addressed to "", 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, is evaluated as equal to

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top