LazyInitializer::EnsureInitialized<T> Method (T%)

.NET Framework (current version)

Initializes a target reference type with the type's default constructor if it hasn't already been initialized.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
generic<typename T>
where T : ref class
static T EnsureInitialized(
	T% target
)

Parameters

target: Type: T%
A reference of type T to initialize if it has not already been initialized.

Return Value

Type: T

The initialized reference of type T.

Type Parameters

T: The type of the reference to be initialized.

Exceptions

Exception	Condition
MemberAccessException	Permissions to access the constructor of type T were missing.
MissingMemberException	Type T does not have a default constructor.

Remarks

This method may only be used on reference types. To ensure initialization of value types, see other overloads of EnsureInitialized.

This method may be used concurrently by multiple threads to initialize target.

In the event that multiple threads access this method concurrently, multiple instances of T may be created, but only one will be stored into target. In such an occurrence, this method will not dispose of the objects that were not stored. If such objects must be disposed, it is up to the caller to determine if an object was not used and to then dispose of the object appropriately.

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1