FormatterServices.GetSafeUninitializedObject メソッド

.NET Framework クラス ライブラリ リファレンス

FormatterServices.GetSafeUninitializedObject メソッド

指定したオブジェクト型の新しいインスタンスを作成します。

名前空間: System.Runtime.Serialization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetSafeUninitializedObject
 ( _
    type As Type _
) As Object

Visual Basic (使用法)

Dim type As Type
Dim returnValue As Object

returnValue = FormatterServices.GetSafeUninitializedObject(type)

C#

public static Object GetSafeUninitializedObject
 (
    Type type
)

C++

public:
static Object^ GetSafeUninitializedObject (
    Type^ type
)

J#

public static Object GetSafeUninitializedObject
 (
    Type type
)

JScript

public static function GetSafeUninitializedObject
 (
    type : Type
) : Object

パラメータ

type

作成するオブジェクトの型。

戻り値
指定した型の、0 に設定されたオブジェクト。

例外

例外の種類	条件
ArgumentNullException	type パラメータが null 参照 (Visual Basic では Nothing) です。
SerializationException	type パラメータが、有効な共通言語ランタイム型ではありません。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

オブジェクトの新しいインスタンスが 0 に初期化され、コンストラクタが実行されないため、オブジェクトによって有効と見なされた状態をオブジェクトが表さない可能性があります。GetSafeUninitializedObject は、ユーザーが全フィールドをすぐに設定する場合の逆シリアル化だけに使用する必要があります。変更不可の型の空のインスタンスを作成しても無効なため、初期化前の状態に戻された文字列は作成されません。

GetSafeUninitializedObject は、すべてのクラス レベルを リンク確認要求 から 確認要求 に変換し、すべての直接的および間接的な呼び出し元に、要求されるアクセス許可があることを確認します。GetSafeUninitializedObject を使用して、部分的に信頼されているソースから逆シリアル化する場合のセキュリティ レベルを強化します。完全に信頼されているソースの場合には、パフォーマンスを向上させるために、GetUninitializedObject を使用します。

.NET Framework のセキュリティ

• SecurityPermission  シリアル化サービスを提供するために必要なアクセス許可。SecurityPermissionFlag.SerializationFormatter、SecurityAction.LinkDemand (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
FormatterServices クラス
FormatterServices メンバ
System.Runtime.Serialization 名前空間