Exception.GetObjectDataとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

Exception.GetObjectData メソッド

派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。

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

Visual Basic (宣言)

Public Overridable Sub GetObjectData
 ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim instance As Exception
Dim info As SerializationInfo
Dim context As StreamingContext

instance.GetObjectData(info, context)

public virtual void GetObjectData (
    SerializationInfo info,
    StreamingContext context
)

C++

public:
virtual void GetObjectData (
    SerializationInfo^ info, 
    StreamingContext context
)

public void GetObjectData (
    SerializationInfo info, 
    StreamingContext context
)

JScript

public function GetObjectData (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info: スローされている例外に関するシリアル化済みオブジェクトデータを保持している SerializationInfo。

context: 転送元または転送先に関するコンテキスト情報を含んでいる StreamingContext。

例外

例外の種類	条件
ArgumentNullException	info パラメータが null 参照 (Visual Basic の場合は Nothing) です。

解説

GetObjectData は、シリアル化する対象のすべての例外オブジェクトデータを使用して、SerializationInfo を設定します。逆シリアル化中に、ストリームで転送された SerializationInfo から例外が再構成されます。

使用例

GetObjectData を実装するシリアル化可能な派生 Exception クラスを定義するコード例を次に示します。Exception クラスにより、2 つのプロパティに小さな変更が行われ、その後に基本クラスが呼び出されてシリアル化が実行されます。この例では、0 による除算エラーを強制し、次に派生例外のインスタンスを作成します。インスタンスをファイルにシリアル化し、そのファイルを新しい例外に逆シリアル化して新しい例外をスローし、その例外のデータをキャッチして表示します。

Visual Basic

' Example for the Exception( SerializationInfo, StreamingContext )
' constructor and the Exception.GetObjectData( SerializationInfo, 
' StreamingContext ) method.
'
' If compiling with the Visual Basic compiler (VBC) from the command
 
' prompt, be sure to add the following switch:
'    /reference:System.Runtime.Serialization.Formatters.Soap.dll 
Imports System
Imports System.IO
Imports System.Runtime.Serialization
Imports System.Runtime.Serialization.Formatters.Soap
Imports Microsoft.VisualBasic
Imports System.Security.Permissions

Namespace NDP_UE_VB

    ' Define a serializable derived exception class.
    <Serializable()>  _
    Class SecondLevelException
        Inherits Exception
       
        ' This public constructor is used by class instantiators.
        Public Sub New(
 message As String, inner As
 Exception )
            MyBase.New( message, inner )

            HelpLink = "http://MSDN.Microsoft.com"
            Source = "Exception_Class_Samples"
        End Sub ' New
       
        ' This protected constructor is used for deserialization.
        Protected Sub New(
 info As SerializationInfo, _
            context As StreamingContext )
                MyBase.New( info, context )
        End Sub ' New
           
           
        ' GetObjectData performs a custom serialization.
        <SecurityPermissionAttribute(SecurityAction.Demand, _
                                     SerializationFormatter:=True)> _
        Overrides Sub GetObjectData( info As
 SerializationInfo, _
            context As StreamingContext) 

            ' Change the case of two properties, and then use the 
            ' method of the base class.
            HelpLink = HelpLink.ToLower()
            Source = Source.ToUpper()
              
            MyBase.GetObjectData(info, context)

        End Sub ' ISerializable.GetObjectData
    End Class ' SecondLevelException


    Module SerializationDemo
       
        Sub Main()
            Console.WriteLine( _
                "This example of the Exception constructor "
 & _
                "and Exception.GetObjectData " &
 vbCrLf & _
                "with SerializationInfo and StreamingContext "
 & _
                "parameters generates " & vbCrLf
 & _
                "the following output." & vbCrLf
 )

            ' This code forces a division by 0 and catches the 
            ' resulting exception.
            Try
                Try
                    Dim zero As Integer
 = 0
                    Dim ecks As Integer
 = 1 \ zero

                ' Create a new exception to throw again.
                Catch ex As Exception
                    
                    Dim newExcept As New
 SecondLevelException( _
                        "Forced a division by 0 and threw "
 & _
                        "another exception.", ex )
                    
                    Console.WriteLine( _
                        "Forced a division by 0, caught the "
 & _
                        "resulting exception, " &
 vbCrLf & _
                        "and created a derived exception:"
 & vbCrLf )
                    Console.WriteLine( "HelpLink: {0}",
 _
                        newExcept.HelpLink )
                    Console.WriteLine( "Source:   {0}",
 _
                        newExcept.Source )
                    
                    ' This FileStream is used for the serialization.
                    Dim stream As New
 FileStream( _
                        "NewException.dat", FileMode.Create
 )
                    
                    ' Serialize the derived exception.
                    Try
                        Dim formatter As New
 SoapFormatter( Nothing, _
                            New StreamingContext( _
                                StreamingContextStates.File ) )
                        formatter.Serialize( stream, newExcept )
                           
                        ' Rewind the stream and deserialize the 
                        ' exception.
                        stream.Position = 0
                        Dim deserExcept As
 SecondLevelException = _
                            CType( formatter.Deserialize( stream ), _
                                SecondLevelException )
                           
                        Console.WriteLine( vbCrLf & _
                            "Serialized the exception, and then
 " & _
                            "deserialized the resulting stream
 " & _
                            "into a " & vbCrLf
 & "new exception. " & _
                            "The deserialization changed the case
 " & _
                            "of certain properties:"
 & vbCrLf )
                        
                        ' Throw the deserialized exception again.
                        Throw deserExcept

                    Catch se As SerializationException
                        Console.WriteLine( "Failed to serialize:
 {0}", _
                            se.ToString( ) )

                    Finally
                        stream.Close( )
                    End Try
                End Try

            Catch ex As Exception
                Console.WriteLine( "HelpLink: {0}",
 ex.HelpLink )
                Console.WriteLine( "Source:   {0}",
 ex.Source )

                Console.WriteLine( )
                Console.WriteLine( ex.ToString( ) )
            End Try
        End Sub ' Main

    End Module ' SerializationDemo
End Namespace ' NDP_UE_VB

' This example of the Exception constructor and Exception.GetObjectData
' with SerializationInfo and StreamingContext parameters generates
' the following output.
' 
' Forced a division by 0, caught the resulting exception,
' and created a derived exception:
' 
' HelpLink: http://MSDN.Microsoft.com
' Source:   Exception_Class_Samples
' 
' Serialized the exception, and then deserialized the resulting stream
 into a
' new exception. The deserialization changed the case of certain properties:
' 
' HelpLink: http://msdn.microsoft.com
' Source:   EXCEPTION_CLASS_SAMPLES
' 
' NDP_UE_VB.SecondLevelException: Forced a division by 0 and threw another
 exce
' ption. ---> System.DivideByZeroException: Attempted to divide by
 zero.
'    at NDP_UE_VB.SerializationDemo.Main()
'    --- End of inner exception stack trace ---
'    at NDP_UE_VB.SerializationDemo.Main()

// Example for the Exception( SerializationInfo, StreamingContext )
// constructor and the Exception.GetObjectData( SerializationInfo, 
// StreamingContext ) method.
using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Soap;
using System.Security.Permissions;

namespace NDP_UE_CS
{
    // Define a serializable derived exception class.
    [Serializable()]
    class SecondLevelException : Exception, ISerializable
    {
        // This public constructor is used by class instantiators.
        public SecondLevelException( string
 message, Exception inner ) :
            base( message, inner )
        {
            HelpLink = "http://MSDN.Microsoft.com";
            Source = "Exception_Class_Samples";
        }

        // This protected constructor is used for deserialization.
        protected SecondLevelException( SerializationInfo info,
 
            StreamingContext context ) :
                base( info, context )
        { }

        // GetObjectData performs a custom serialization.
        [SecurityPermissionAttribute(SecurityAction.Demand,SerializationFormatter=true)]
        public override void GetObjectData(
 SerializationInfo info, 
            StreamingContext context ) 
        {
            // Change the case of two properties, and then use the 
            // method of the base class.
            HelpLink = HelpLink.ToLower( );
            Source = Source.ToUpper( );

            base.GetObjectData( info, context );
        }
    }

    class SerializationDemo 
    {
        public static void
 Main() 
        {
            Console.WriteLine( 
                "This example of the Exception constructor " +
                "and Exception.GetObjectData\nwith Serialization" +
                "Info and StreamingContext parameters " +
                "generates \nthe following output.\n" );

            try
            {
                // This code forces a division by 0 and catches the
 
                // resulting exception.
                try
                {
                    int  zero = 0;
                    int  ecks = 1 / zero;
                }
                catch( Exception ex )
                {
                    // Create a new exception to throw again.
                    SecondLevelException newExcept =
                        new SecondLevelException( 
                            "Forced a division by 0 and threw " +
                            "another exception.", ex );

                    Console.WriteLine( 
                        "Forced a division by 0, caught the " +
                        "resulting exception, \n" +
                        "and created a derived exception:\n" );
                    Console.WriteLine( "HelpLink: {0}", 
                        newExcept.HelpLink );
                    Console.WriteLine( "Source:   {0}", 
                        newExcept.Source );

                    // This FileStream is used for the serialization.
                    FileStream stream = 
                        new FileStream( "NewException.dat",
 
                            FileMode.Create );

                    try
                    {
                        // Serialize the derived exception.
                        SoapFormatter formatter = 
                            new SoapFormatter( null
,
                                new StreamingContext( 
                                    StreamingContextStates.File ) );
                        formatter.Serialize( stream, newExcept );

                        // Rewind the stream and deserialize the 
                        // exception.
                        stream.Position = 0;
                        SecondLevelException deserExcept = 
                            (SecondLevelException)
                                formatter.Deserialize( stream );

                        Console.WriteLine( 
                            "\nSerialized the exception, and then " +
                            "deserialized the resulting stream " +
                            "into a \nnew exception. " +
                            "The deserialization changed the case
 " +
                            "of certain properties:\n" );
                        
                        // Throw the deserialized exception again.
                        throw deserExcept;
                    }
                    catch( SerializationException se )
                    {
                        Console.WriteLine( "Failed to serialize: {0}",
 
                            se.ToString( ) );
                    }
                    finally
                    {
                        stream.Close( );
                    }
                }
            }
            catch( Exception ex )
            {
                Console.WriteLine( "HelpLink: {0}", ex.HelpLink );
                Console.WriteLine( "Source:   {0}", ex.Source );

                Console.WriteLine( );
                Console.WriteLine( ex.ToString( ) );
            }
        }
    }
}

/*
This example of the Exception constructor and Exception.GetObjectData
with SerializationInfo and StreamingContext parameters generates
the following output.

Forced a division by 0, caught the resulting exception,
and created a derived exception:

HelpLink: http://MSDN.Microsoft.com
Source:   Exception_Class_Samples

Serialized the exception, and then deserialized the resulting stream into a
new exception. The deserialization changed the case
 of certain properties:

HelpLink: http://msdn.microsoft.com
Source:   EXCEPTION_CLASS_SAMPLES

NDP_UE_CS.SecondLevelException: Forced a division by 0 and threw another except
ion. ---> System.DivideByZeroException: Attempted to divide by zero.
   at NDP_UE_CS.SerializationDemo.Main()
   --- End of inner exception stack trace ---
   at NDP_UE_CS.SerializationDemo.Main()
*/

C++

// Example for the Exception( SerializationInfo, StreamingContext )
// constructor and the Exception.GetObjectData( SerializationInfo, 
// StreamingContext ) method.
#using <System.Runtime.Serialization.Formatters.Soap.dll>

using namespace System;
using namespace System::IO;
using namespace System::Runtime::Serialization;
using namespace System::Runtime::Serialization::Formatters::Soap;

// Define a serializable derived exception class.

[Serializable]
ref class SecondLevelException: public Exception,
 public ISerializable
{
public:

   // This public constructor is used by class instantiators.
   SecondLevelException( String^ message, Exception^ inner )
      : Exception( message, inner )
   {
      HelpLink = "http://MSDN.Microsoft.com";
      Source = "Exception_Class_Samples";
   }


protected:

   // This protected constructor is used for deserialization.
   SecondLevelException( SerializationInfo^ info, StreamingContext context )
      : Exception( info, context )
   {}


public:

   // GetObjectData performs a custom serialization.
   [System::Security::Permissions::SecurityPermissionAttribute
   (System::Security::Permissions::SecurityAction::LinkDemand, 
   Flags=System::Security::Permissions::SecurityPermissionFlag::SerializationFormatter)]
   virtual void GetObjectData( SerializationInfo^ info, StreamingContext
 context ) override
   {
      
      // Change the case of two properties, and then use the 
      // method of the base class.
      HelpLink = HelpLink->ToLower();
      Source = Source->ToUpper();
      Exception::GetObjectData( info, context );
   }

};

int main()
{
   Console::WriteLine( "This example of the Exception constructor "
   "and Exception.GetObjectData\nwith Serialization"
   "Info and StreamingContext parameters "
   "generates \nthe following output.\n" );
   try
   {
      
      // This code forces a division by 0 and catches the 
      // resulting exception.
      try
      {
         int zero = 0;
         int ecks = 1 / zero;
      }
      catch ( Exception^ ex ) 
      {
         
         // Create a new exception to throw again.
         SecondLevelException^ newExcept = gcnew SecondLevelException( "Forced
 a division by 0 and threw "
         "another exception.",ex );
         Console::WriteLine( "Forced a division by 0, caught the "
         "resulting exception, \n"
         "and created a derived exception:\n" );
         Console::WriteLine( "HelpLink: {0}", newExcept->HelpLink );
         Console::WriteLine( "Source:   {0}", newExcept->Source );
         
         // This FileStream is used for the serialization.
         FileStream^ stream = gcnew FileStream( "NewException.dat",FileMode::Create
 );
         try
         {
            
            // Serialize the derived exception.
            SoapFormatter^ formatter = gcnew SoapFormatter( nullptr,StreamingContext(StreamingContextStates::File)
 );
            formatter->Serialize( stream, newExcept );
            
            // Rewind the stream and deserialize the 
            // exception.
            stream->Position = 0;
            SecondLevelException^ deserExcept = dynamic_cast<SecondLevelException^>(formatter->Deserialize(
 stream ));
            Console::WriteLine( "\nSerialized the exception, and then "
            "deserialized the resulting stream "
            "into a \nnew exception. "
            "The deserialization changed the case "
            "of certain properties:\n" );
            
            // Throw the deserialized exception again.
            throw deserExcept;
         }
         catch ( SerializationException^ se ) 
         {
            Console::WriteLine( "Failed to serialize: {0}", se->ToString()
 );
         }
         finally
         {
            stream->Close();
         }

      }

   }
   catch ( Exception^ ex ) 
   {
      Console::WriteLine( "HelpLink: {0}", ex->HelpLink );
      Console::WriteLine( "Source:   {0}", ex->Source );
      Console::WriteLine();
      Console::WriteLine( ex->ToString() );
   }

}

/*
This example of the Exception constructor and Exception.GetObjectData
with SerializationInfo and StreamingContext parameters generates
the following output.

Forced a division by 0, caught the resulting exception,
and created a derived exception:

HelpLink: http://MSDN.Microsoft.com
Source:   Exception_Class_Samples

Serialized the exception, and then deserialized the resulting stream into a
new exception. The deserialization changed the case
 of certain properties:

HelpLink: http://msdn.microsoft.com
Source:   EXCEPTION_CLASS_SAMPLES

SecondLevelException: Forced a division by 0 and threw another exception. --->
 S
ystem.DivideByZeroException: Attempted to divide by zero.
   at main()
   --- End of inner exception stack trace ---
   at main()

*/

.NET Framework のセキュリティ

SecurityPermission (シリアル化サービスを提供する機能に必要なアクセス許可)。要求値 : LinkDemand; アクセス許可値 : SerializationFormatter

プラットフォーム

バージョン情報

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

参照

関連項目
Exception クラス
Exception メンバ
System 名前空間
SerializationInfo
StreamingContext

_Exception.GetObjectData メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

COM オブジェクトに、Exception.GetObjectData メソッドへのバージョンに依存しないアクセスが用意されています。

このメソッドは、CLS に準拠していません。

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

Visual Basic (宣言)

Sub GetObjectData ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim instance As _Exception
Dim info As SerializationInfo
Dim context As StreamingContext

instance.GetObjectData(info, context)

void GetObjectData (
    SerializationInfo info,
    StreamingContext context
)

C++

void GetObjectData (
    SerializationInfo^ info, 
    StreamingContext context
)

void GetObjectData (
    SerializationInfo info, 
    StreamingContext context
)

JScript

function GetObjectData (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info: スローされている例外に関するシリアル化済みオブジェクトデータを保持している SerializationInfo オブジェクト。

context: 転送元または転送先に関する文脈情報を含んでいる StreamingContext 構造体。

解説

このメソッドは、アンマネージコードからマネージクラスにアクセスするためのメソッドであるため、マネージコードからは呼び出さないでください。

Exception.GetObjectData メソッドは、例外に関する情報を使用して SerializationInfo オブジェクトを設定します。

.NET Framework のセキュリティ

SecurityPermission (シリアル化サービスを提供する機能に必要なアクセス許可)。 SerializationFormatter (関連する列挙体)。LinkDemand (セキュリティアクション)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
_Exception インターフェイス
_Exception メンバ
System.Runtime.InteropServices 名前空間
Exception.GetObjectData

このページでは「.NET Framework クラスライブラリリファレンス」からException.GetObjectDataを検索した結果を表示しています。
Weblioに収録されているすべての辞書からException.GetObjectDataを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からException.GetObjectData を検索

>> 「Exception.GetObjectData」を含む用語の索引
Exception.GetObjectDataのページへのリンク

Exception.GetObjectDataとは？わかりやすく解説

Exception.GetObjectData メソッド

_Exception.GetObjectData メソッド

「Exception.GetObjectData」の関連用語


	© 2025 Microsoft.All rights reserved.

Exception.GetObjectDataとは？ わかりやすく解説

Exception.GetObjectData メソッド

_Exception.GetObjectData メソッド

急上昇のことば

「Exception.GetObjectData」の関連用語

Exception.GetObjectDataとは？わかりやすく解説