BinaryFormatter.UnsafeDeserialize メソッド

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

BinaryFormatter.UnsafeDeserialize メソッド

指定したストリームをオブジェクト グラフに逆シリアル化します。そのストリーム内にヘッダーがある場合は、指定した HeaderHandler がそのヘッダーを処理します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Function UnsafeDeserialize ( _
    serializationStream As Stream, _
    handler As HeaderHandler _
) As Object

Visual Basic (使用法)

Dim instance As BinaryFormatter
Dim serializationStream As Stream
Dim handler As HeaderHandler
Dim returnValue As Object

returnValue = instance.UnsafeDeserialize(serializationStream, handler)

C#

[ComVisibleAttribute(false)] 
public Object UnsafeDeserialize (
    Stream serializationStream,
    HeaderHandler handler
)

C++

[ComVisibleAttribute(false)] 
public:
Object^ UnsafeDeserialize (
    Stream^ serializationStream, 
    HeaderHandler^ handler
)

J#

/** @attribute ComVisibleAttribute(false) */ 
public Object UnsafeDeserialize (
    Stream serializationStream, 
    HeaderHandler handler
)

JScript

ComVisibleAttribute(false) 
public function UnsafeDeserialize (
    serializationStream : Stream, 
    handler : HeaderHandler
) : Object

パラメータ

serializationStream

オブジェクト グラフを逆シリアル化する元となるストリーム。

handler

serializationStream 内にヘッダーがある場合に、そのヘッダーを処理する HeaderHandler。null 参照 (Visual Basic では Nothing) でもかまいません。

戻り値
逆シリアル化されたオブジェクトまたはオブジェクト グラフの先頭 (ルート) オブジェクト。

例外

例外の種類	条件
ArgumentNullException	serializationStream が null 参照 (Visual Basic では Nothing) です。
SerializationException	serializationStream はシークをサポートしていますが、長さが 0 です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

ヘッダーは、特定のリモート処理アプリケーションでだけ使用されます。

このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.SerializationFormatter アクセス許可は、直前の呼び出し元にのみ要求されます。コードが部分的に信頼されているコードから呼び出される可能性がある場合は、このメソッドを使用しないでください。部分的に信頼されているコードの場合は、代わりに Deserialize を使用します。完全に信頼されているコードの場合は、Deserialize を使用するよりも UnsafeDeserialize を使用した方がパフォーマンスが向上します。

逆シリアル化を正常に実行するには、ストリーム内の現在の位置をオブジェクト グラフの先頭にする必要があります。

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

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