An error occurred during search results load.
Assembly mask is a text pattern format designed for .NET assemblies selection. It is based on glob mask format but contains behavioral alterations to make the process of assembly selection more natural. Assembly mask is supported by assembly merging and assembly embedding.
Assembly mask syntax is equivalent to glob mask syntax:
Table 7.4. The list of available wildcard characters
| Wildcard | Description |
|---|---|
?
| Matches a single character |
*
| Matches any number of characters, including zero |
Wildcard characters are combined into a string to form an assembly mask with the desired properties.
When an assembly mask starts with ^ and ends with $ characters, it is switched to regex mask mode.
Assembly mask differs from the glob mask in semantic behavior in order to accommodate the de jure and de facto conventions of .NET assembly naming.
Let's take a look at Contoso.QuickRun.Engine.dll assembly name.
It represents a hierarchal assembly name where Contoso is a company name,
QuickRun is a product name,
and Engine is a subsystem name.
The naming may then descend into deeper hierarchical levels, like so:
Contoso.QuickRun.Engine.Contracts.dll - the contract module of Engine subsystem of the product
Contoso.QuickRun.Engine.Dal.dll - the data access layer of the engine
Contoso.QuickRun.Engine.Integration.B2B.dll - B2B integration facilities of the engine
What should a mask like Contoso.QuickRun.Engine.*.dll select?
Should it only select the submodules of Engine subsystem, or should it include Contoso.QuickRun.Engine.dll assembly as well, thus covering the whole semantical scope?
Glob mask would select only the submodules, but assembly mask selects Contoso.QuickRun.Engine.dll assembly as well, and that is a conceptual difference between the two.
Assembly mask makes it more handy to select .NET assemblies by interpreting the structural meaning of a pattern
[1].
If such interpretation is not desired, the following assembly mask can be used instead: Contoso.QuickRun.Engine.?*.dll (note the question mark before the star).
It mandates that there should be at least one character at the beginning of the string that follows after Contoso.QuickRun.Engine. prefix and before .dll suffix.
Such mask matches the submodules only and does not include Contoso.QuickRun.Engine.dll in the result.
Table 7.5. Assembly mask examples
| Assembly Mask | Description |
|---|---|
ABC*.dll
| Matches any assembly with a name starting with "ABC" and ending with ".dll" |
A.*.dll
| Matches any assembly with a name starting with "A." and ending with ".dll", including "A.dll" |
A.?*.dll
| Matches any assembly with a name starting with "A." and ending with ".dll", but not "A.dll" |