LazyInitializer.EnsureInitialized メソッド

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.dll

まだ初期化されていない場合は、ターゲットの型を初期化します。

オーバーロード

EnsureInitialized<T>(T)	まだ初期化されていない場合、型のパラメーターなしのコンストラクターを使用してターゲット参照型を初期化します。
EnsureInitialized<T>(T, Func<T>)	まだ初期化されていない場合、指定された関数を使用してターゲット参照型を初期化します。
EnsureInitialized<T>(T, Boolean, Object)	まだ初期化されていない場合、そのパラメーターなしのコンストラクターを使用してターゲット参照または値の型を初期化します。
EnsureInitialized<T>(T, Object, Func<T>)	まだ初期化されていない場合、指定された関数を使用してターゲット参照型を初期化します。
EnsureInitialized<T>(T, Boolean, Object, Func<T>)	まだ初期化されていない場合、指定された関数を使用することでターゲット参照または値の型を初期化します。

EnsureInitialized<T>(T)

ソース:

LazyInitializer.cs

まだ初期化されていない場合、型のパラメーターなしのコンストラクターを使用してターゲット参照型を初期化します。

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

public static T EnsureInitialized<T> (ref T? target) where T : class;

static member EnsureInitialized : 'T -> 'T (requires 'T : null)

Public Shared Function EnsureInitialized(Of T As Class) (ByRef target As T) As T

型パラメーター

T

初期化される参照の型。

パラメーター

target

T

まだ初期化されていない場合、初期化する参照。 これが null の場合は、初期化されていないと見なされます。それ以外の場合は、初期化されていると見なされます。

戻り値

T

初期化されたオブジェクト。

例外

MemberAccessException

型 T のコンストラクターにアクセスするためのアクセス許可がありませんでした。

MissingMemberException

型 T には、パラメーターなしのコンストラクターがありません。

注釈

このメソッドは、参照型でのみ使用できます。 値型の初期化を保証するには、 の他の EnsureInitializedオーバーロードを参照してください。

このメソッドは、 を初期化 targetするために複数のスレッドで同時に使用できます。

複数のスレッドがこのメソッドに同時にアクセスする場合は、 の複数の T インスタンスを作成できますが、 に target 格納されて返されるのは 1 つだけです。 このような場合、このメソッドは、格納されていないオブジェクトを破棄しません。 このようなオブジェクトを破棄する必要がある場合は、 を受け取る valueFactory オーバーロードを使用し、同じ格納されているオブジェクトを参照していない場合は オブジェクトを破棄します。

こちらもご覧ください

• 限定的な初期化

EnsureInitialized<T>(T, Func<T>)

ソース:

LazyInitializer.cs

まだ初期化されていない場合、指定された関数を使用してターゲット参照型を初期化します。

public:
generic <typename T>
 where T : class static T EnsureInitialized(T % target, Func<T> ^ valueFactory);

public static T EnsureInitialized<T> (ref T? target, Func<T> valueFactory) where T : class;

static member EnsureInitialized : 'T * Func<'T (requires 'T : null)> -> 'T (requires 'T : null)

Public Shared Function EnsureInitialized(Of T As Class) (ByRef target As T, valueFactory As Func(Of T)) As T

型パラメーター

T

初期化される参照の型。

パラメーター

target

T

まだ初期化されていない場合、初期化する参照。

valueFactory

Func<T>

参照を初期化するために呼び出される関数。

戻り値

T

初期化されたオブジェクト。

例外

MissingMemberException

型 T には、パラメーターなしのコンストラクターがありません。

InvalidOperationException

valueFactory では null (Visual Basic の場合は Nothing) を返しました。

注釈

このメソッドは、参照型でのみ使用でき、 valueFactory null 参照を返さない場合があります (Visual Basic では Nothing)。 値型の初期化を確実に行うか、null 参照型を許可するには、EnsureInitialized の他のオーバーロードを参照してください。

このメソッドは、 を初期化 targetするために複数のスレッドで同時に使用できます。

複数のスレッドがこのメソッドに同時にアクセスする場合は、 の複数の T インスタンスを作成できますが、 に target格納されるのは 1 つだけです。 このような場合、このメソッドは、格納されていないオブジェクトを破棄しません。 このようなオブジェクトを破棄する必要がある場合は、オブジェクトが使用されていないかどうかを判断し、そのオブジェクトを適切に破棄するのは呼び出し元の責任です。

こちらもご覧ください

• 限定的な初期化

EnsureInitialized<T>(T, Boolean, Object)

ソース:

LazyInitializer.cs

まだ初期化されていない場合、そのパラメーターなしのコンストラクターを使用してターゲット参照または値の型を初期化します。

public:
generic <typename T>
 static T EnsureInitialized(T % target, bool % initialized, System::Object ^ % syncLock);

public static T EnsureInitialized<T> (ref T target, ref bool initialized, ref object? syncLock);

static member EnsureInitialized : 'T * bool * obj -> 'T

Public Shared Function EnsureInitialized(Of T) (ByRef target As T, ByRef initialized As Boolean, ByRef syncLock As Object) As T

型パラメーター

T

初期化される参照の型。

パラメーター

target

T

初期化されていない場合に初期化する型 T の参照または値。

initialized

Boolean

ターゲットが既に初期化されているかどうかを判断するブール値への参照。

syncLock

Object

target を初期化するために相互排他的ロックとして使用されるオブジェクトへの参照。 syncLock が null の場合、新しいオブジェクトがインスタンス化されます。

戻り値

T

初期化されたオブジェクト。

例外

MemberAccessException

型 T のコンストラクターにアクセスするためのアクセス許可がありませんでした。

MissingMemberException

型 T には、パラメーターなしのコンストラクターがありません。

注釈

が true として指定されている場合 initialized 、それ以上の初期化は行われません。

こちらもご覧ください

• 限定的な初期化

EnsureInitialized<T>(T, Object, Func<T>)

ソース:

LazyInitializer.cs

まだ初期化されていない場合、指定された関数を使用してターゲット参照型を初期化します。

public:
generic <typename T>
 where T : class static T EnsureInitialized(T % target, System::Object ^ % syncLock, Func<T> ^ valueFactory);

public static T EnsureInitialized<T> (ref T? target, ref object? syncLock, Func<T> valueFactory) where T : class;

static member EnsureInitialized : 'T * obj * Func<'T (requires 'T : null)> -> 'T (requires 'T : null)

Public Shared Function EnsureInitialized(Of T As Class) (ByRef target As T, ByRef syncLock As Object, valueFactory As Func(Of T)) As T

型パラメーター

T

初期化される参照の型。

パラメーター

target

T

まだ初期化されていない場合、初期化する参照。 これが null の場合は、初期化されていないと見なされます。それ以外の場合は、初期化されていると見なされます。

syncLock

Object

target を初期化するために相互排他的ロックとして使用されるオブジェクトへの参照。 syncLock が null の場合、新しいオブジェクトがインスタンス化されます。

valueFactory

Func<T>

target を初期化するために呼び出すメソッド。

戻り値

T

初期化されたオブジェクト。

EnsureInitialized<T>(T, Boolean, Object, Func<T>)

ソース:

LazyInitializer.cs

まだ初期化されていない場合、指定された関数を使用することでターゲット参照または値の型を初期化します。

public:
generic <typename T>
 static T EnsureInitialized(T % target, bool % initialized, System::Object ^ % syncLock, Func<T> ^ valueFactory);

public static T EnsureInitialized<T> (ref T target, ref bool initialized, ref object? syncLock, Func<T> valueFactory);

static member EnsureInitialized : 'T * bool * obj * Func<'T> -> 'T

Public Shared Function EnsureInitialized(Of T) (ByRef target As T, ByRef initialized As Boolean, ByRef syncLock As Object, valueFactory As Func(Of T)) As T

型パラメーター

T

初期化される参照の型。

パラメーター

target

T

初期化されていない場合に初期化する型 T の参照または値。

initialized

Boolean

ターゲットが既に初期化されているかどうかを判断するブール値への参照。

syncLock

Object

target を初期化するために相互排他的ロックとして使用されるオブジェクトへの参照。 syncLock が null の場合、新しいオブジェクトがインスタンス化されます。

valueFactory

Func<T>

参照または値を初期化するために呼び出される関数。

戻り値

T

初期化されたオブジェクト。

例外

MemberAccessException

型 T のコンストラクターにアクセスするためのアクセス許可がありませんでした。

MissingMemberException

型 T には、パラメーターなしのコンストラクターがありません。

注釈

が true として指定されている場合 initialized 、それ以上の初期化は行われません。

こちらもご覧ください

• 限定的な初期化