Exception.SerializeObjectState イベント

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

ソース:

Exception.cs

注意事項

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。

protected:
 event EventHandler<System::Runtime::Serialization::SafeSerializationEventArgs ^> ^ SerializeObjectState;

[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected event EventHandler<System.Runtime.Serialization.SafeSerializationEventArgs>? SerializeObjectState;

[<System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
member this.SerializeObjectState : EventHandler<System.Runtime.Serialization.SafeSerializationEventArgs> 

Protected Custom Event SerializeObjectState As EventHandler(Of SafeSerializationEventArgs) 

イベントの種類

EventHandler<SafeSerializationEventArgs>

属性

ObsoleteAttribute

注釈

例外状態オブジェクトは、 インターフェイスを ISafeSerializationData 実装します。

イベントが SerializeObjectState サブスクライブされると、例外は逆シリアル化され、空の例外として作成されます。 例外のコンストラクターは実行されず、例外の状態も逆シリアル化されます。 CompleteDeserializationその後、例外状態オブジェクトのコールバック メソッドに通知され、逆シリアル化されたデータを空の例外にプッシュできるようになります。

イベント SerializeObjectState を使用すると、透過的な例外の種類で例外データをシリアル化および逆シリアル化できます。 透過的なコードでは、操作しているアクセス許可セットの境界内でコマンドを実行できますが、重要なコードの実行、呼び出し、派生、または含めることはできません。

イベントが SerializeObjectState サブスクライブされていない場合は、 コンストラクターを使用して通常どおり逆シリアル化が Exception 行われます。

通常、イベントの SerializeObjectState ハンドラーは、そのシリアル化を提供するために例外のコンストラクターに追加されます。 ただし、イベント ハンドラーの実行時 SerializeObjectState にコンストラクターが実行されないため、逆シリアル化された例外をシリアル化すると、例外を SerializationException 逆シリアル化しようとすると例外がスローされる可能性があります。 これを回避するには、 メソッドに ISafeSerializationData.CompleteDeserialization イベントのハンドラーをSerializeObjectState追加する必要もあります。 図については、「例」セクションを参照してください。

注意 (継承者)

このイベントがサブスクライブされ、使用されている場合、継承階層に続くすべての派生型は、同じシリアル化メカニズムを実装する必要があります。