Share via

The Namespace Matching Rule

  • Article
Retired Content

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
The latest Enterprise Library information can be found at the Enterprise Library site.

The Namespace Matching Rule allows developers, operators, and administrators to select target classes based on their namespace, using wildcard characters for the child namespace names but not for the root namespace name.

Note

The Policy Injection Application Block includes matching rule configuration placeholders that provide backward compatibility. The implementation of matching rules is described in the Unity Application Block documentation. For more information, see The Namespace Matching Rule in the Unity Application Block documentation.

Configuration Settings of the Namespace Matching Rule

The configuration settings available for the Namespace Matching Rule are a collection of namespace name matches, each consisting of two properties:

  • Match (String). This is the namespace of the target object, such as "MyObjects.BusinessRules" or "System.Collections". It can include the * or ? wildcard characters to select multiple child namespaces. The following are examples:
    • System.Collections.*
    • MyObjects.Order*
    • MyObjects.Order??
    • MyObjects.*
  • IgnoreCase (Boolean). This specifies whether the match should be carried out on a case-sensitive basis.

The next procedure describes how to configure the Namespace Matching Rule using the Configuration Console or the Visual Studio Configuration Editor.

To configure the Namespace Matching Rule

  1. Right-click the Matching Rules node in the Enterprise Library Configuration Console or Visual Studio Configuration Editor, point to New, and then click Namespace Matching Rule.
  2. In the right pane of the Enterprise Library Configuration Console, or in the Visual Studio Properties window, select the Name property, and then change the default name to the name you want to use for the new matching rule.
  3. Select the Matches property, and then click the ellipsis button (...) to open the Match Collection Editor dialog box.
  4. Click Add and, in the right pane of the dialog box, enter the target namespace in the Value property. You can use the * or ? wildcard characters, but you must include the full root namespace and the period (.) that follows it.
  5. Select either True or False in the drop-down list for the IgnoreCase property.
  6. Repeat steps 4 and 5 to add all the namespace name matches you require, and then click OK to close the Match Collection Editor dialog box.