DirectoryCatalog Constructor (String, String, ICompositionElement)

.NET Framework 4.5

Initializes a new instance of the DirectoryCatalog class by using ComposablePartDefinition objects based on the specified search pattern in the specified directory path with the specified source for parts.

Namespace:  System.ComponentModel.Composition.Hosting
Assembly:  System.ComponentModel.Composition (in System.ComponentModel.Composition.dll)

public:
DirectoryCatalog(
	String^ path, 
	String^ searchPattern, 
	ICompositionElement^ definitionOrigin
)

Parameters

path
Type: System::String

The path to the directory to scan for assemblies to add to the catalog.

The path must be absolute or relative to BaseDirectory.

searchPattern
Type: System::String

The search string. The format of the string should be the same as specified for the GetFiles method.

definitionOrigin
Type: System.ComponentModel.Composition.Primitives::ICompositionElement

The element used by diagnostics to identify the source for parts.

ExceptionCondition
DirectoryNotFoundException

The specified path is invalid (for example, it is on an unmapped drive).

ArgumentNullException

path or searchPattern is nullptr.

UnauthorizedAccessException

The caller does not have the required permission.

ArgumentException

path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.

-or-

searchPattern does not contain a valid pattern.

PathTooLongException

The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based computers, paths must be less than 248 characters and file names must be less than 260 characters.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5

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.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft