.NET Framework Class Library
LazyInitializer..::.EnsureInitialized<(Of <(T>)>) Method (T%, Func<(Of <(T>)>))

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Initializes a target reference type using the specified function if it has not already been initialized.

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

Visual Basic (Declaration)
Public Shared Function EnsureInitialized(Of T As Class) ( _
    ByRef target As T, _
    valueFactory As Func(Of T) _
) As T
Visual Basic (Usage)
Dim target As T
Dim valueFactory As Func(Of T)
Dim returnValue As T

returnValue = LazyInitializer.EnsureInitialized(target, _
    valueFactory)
C#
public static T EnsureInitialized<T>(
    ref T target,
    Func<T> valueFactory
)
where T : class
Visual C++
public:
generic<typename T>
where T : ref class
static T EnsureInitialized(
    T% target, 
    Func<T>^ valueFactory
)
F#
static member EnsureInitialized : 
        target:'T byref * 
        valueFactory:Func<'T> -> 'T  when 'T : not struct

Type Parameters

T

The reference type of the reference to be initialized.

Parameters

target
Type: T%
The reference of type to initialize if it has not already been initialized.
valueFactory
Type: System..::.Func<(Of <(T>)>)
The Func<(Of <(T>)>) invoked to initialize the reference.

Return Value

Type: T
The initialized reference of type .
Exceptions

ExceptionCondition
MissingMemberException

Type does not have a default constructor.

InvalidOperationException

valueFactory returned null.

Remarks

This method may only be used on reference types, and valueFactory may not return a null reference (Nothing in Visual Basic). To ensure initialization of value types or to allow null reference 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 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.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4
See Also

Reference

Page view tracker