ExportFactory<T> Class

.NET Framework (current version)

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

A factory that creates new instances of a part that provides the specified export.

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

    System.ComponentModel.Composition.ExportFactory<T, TMetadata>

public class ExportFactory<T>

Type Parameters


The type of the export.

System_CAPS_pubmethodExportFactory<T>(Func<Tuple<T, Action>>)

Initializes a new instance of the ExportFactory<T> class.


Creates an instance of the factory's export type.


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.)


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


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

When you refer indirectly to a part by using a Lazy<T> object, the Value property always returns a reference to the same object. In some circumstances, you might want each reference to result in the creation of a new object. ExportFactory<T> is designed for those scenarios.

ExportFactory<T> can be used in a similar fashion to Lazy<T> when creating attributed parts. That is, an import contract that is defined on ExportFactory<T> with a generic parameter of T will match an export that is defined on T. For example, the follow export and import match:

public String myData = "Example Data.";

public ExportFactory<String> theData { get; set; }

The ExportFactory<T>.CreateExport method returns an ExportLifetimeContext<T> object, which has two pieces. The ExportLifetimeContext<T>.Value property provides access to the created part. Calling the Dispose method of the ExportLifetimeContext<T> object cleans up the created part and all of its dependencies, thereby allowing the part's lifetime to be managed without reference to the container that created it.

.NET Framework
Available since 4.5
Available since 4.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