BinaryFormatterとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

BinaryFormatter クラス

オブジェクト、または連結された複数のオブジェクトから成るグラフ全体を、バイナリ形式でシリアル化および逆シリアル化します。

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

Visual Basic (宣言)
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 BinaryFormatter
    Implements IRemotingFormatter, IFormatter
Visual Basic (使用法)
Dim instance As BinaryFormatter
C#
[ComVisibleAttribute(true)] 
public sealed class BinaryFormatter : IRemotingFormatter,
 IFormatter
C++
[ComVisibleAttribute(true)] 
public ref class BinaryFormatter sealed : IRemotingFormatter,
 IFormatter
J#
/** @attribute ComVisibleAttribute(true) */ 
public final class BinaryFormatter implements
 IRemotingFormatter, IFormatter
JScript
ComVisibleAttribute(true) 
public final class BinaryFormatter implements
 IRemotingFormatter, IFormatter
解説解説

SoapFormatter クラスおよび BinaryFormatter クラスは、IRemotingFormatter インターフェイスを実装してリモート プロシージャ コール (RPC: Remote Procedure Call) をサポートし、IFormatter インターフェイス (IRemotingFormatter によって継承される) を実装してオブジェクト グラフのシリアル化をサポートしています。SoapFormatter クラスは ISoapMessage オブジェクトを使用した RPC もサポートしますが、この場合は IRemotingFormatter 機能は使用しません。

IRemotingFormatter インターフェイスでは、RPC 時に、シリアル化するオブジェクトのグラフと、リモート関数呼び出しに関する情報 (トランザクション ID やメソッド シグネチャなど) を伝達するヘッダー オブジェクトの配列を格納する追加のグラフという、2 つの別個のグラフを指定できます。

BinaryFormatter を使用する RPC は、メソッドの呼び出しと応答という 2 つの部分に区別されます。呼び出しは、呼び出し先のメソッドを保持しているリモート オブジェクト情報と共にサーバーに送信され、応答は、呼び出されたメソッドからのステータス情報や応答情報と共にサーバーからクライアントに送信されます。

メソッドの呼び出しのシリアル化時には、オブジェクト グラフの最初のオブジェクトが IMethodCallMessage インターフェイスをサポートしている必要があります。メソッドの呼び出しを逆シリアル化するには、HeaderHandler パラメータを指定して Deserialize メソッドを使用します。リモート処理インフラストラクチャは、HeaderHandler デリゲートを使用して、ISerializable インターフェイスをサポートするオブジェクトを生成します。BinaryFormatter が HeaderHandler デリゲートを呼び出すと、呼び出し中のメソッドを保持しているリモート オブジェクトの URI が返されます。返されたグラフ内の最初のオブジェクトは、IMethodCallMessage インターフェイスをサポートしています。

メソッドの応答に対するシリアル化プロシージャは、オブジェクト グラフの最初のオブジェクトが IMethodReturnMessage インターフェイスをサポートする必要があることを除けば、メソッドの呼び出しに対するシリアル化プロシージャと同じです。メソッドの応答を逆シリアル化するには、DeserializeMethodResponse メソッドを使用します。時間を短縮するため、メソッドの呼び出し時には、呼び出し元オブジェクトに関する詳細情報はリモート オブジェクトに送信されません。これらの情報は、代わりにメソッドの元の呼び出しから取得され、IMethodCallMessage パラメータで DeserializeMethodResponse メソッドに渡されます。DeserializeMethodResponse メソッドによって返されたグラフ内の最初のオブジェクトは、IMethodReturnMessage インターフェイスをサポートしています。

対になっていないサロゲート

対になっていないサロゲート文字は、バイナリ シリアル化で失われます。たとえば、次の文字列には、2 つの Test という単語の間に、上位サロゲートの Unicode 文字 (\ud800) が含まれています。

Test\ud800Test

シリアル化前のこの文字列のバイト配列は次のとおりです。

バイト配列値

文字

84

T

101

e

115

s

116

t

55296

\ud800

84

T

101

e

115

s

116

t

逆シリアル化後には、上位サロゲートの Unicode 文字は次のように失われます。

バイト配列値

文字

84

T

101

e

115

s

116

t

84

T

101

e

115

s

116

t
使用例使用例
Visual Basic
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization.Formatters.Binary
Imports System.Runtime.Serialization


Module App

    Sub Main()
        Serialize()
        Deserialize()
    End Sub

    Sub Serialize()

        ' Create a hashtable of values that will eventually be serialized.
        Dim addresses As New
 Hashtable
        addresses.Add("Jeff", "123
 Main Street, Redmond, WA 98052")
        addresses.Add("Fred", "987
 Pine Road, Phila., PA 19116")
        addresses.Add("Mary", "PO
 Box 112233, Palo Alto, CA 94301")

        ' To serialize the hashtable (and its key/value pairs),  
        ' you must first open a stream for writing. 
        ' In this case, use a file stream.
        Dim fs As New FileStream("DataFile.dat",
 FileMode.Create)

        ' Construct a BinaryFormatter and use it to serialize the data
 to the stream.
        Dim formatter As New
 BinaryFormatter
        Try
            formatter.Serialize(fs, addresses)
        Catch e As SerializationException
            Console.WriteLine("Failed to serialize. Reason: "
 & e.Message)
            Throw
        Finally
            fs.Close()
        End Try
    End Sub



    Sub Deserialize()
        ' Declare the hashtable reference.
        Dim addresses As Hashtable = Nothing

        ' Open the file containing the data that you want to deserialize.
        Dim fs As New FileStream("DataFile.dat",
 FileMode.Open)
        Try
            Dim formatter As New
 BinaryFormatter

            ' Deserialize the hashtable from the file and 
            ' assign the reference to the local variable.
            addresses = DirectCast(formatter.Deserialize(fs),
 Hashtable)
        Catch e As SerializationException
            Console.WriteLine("Failed to deserialize. Reason:
 " & e.Message)
            Throw
        Finally
            fs.Close()
        End Try

        ' To prove that the table deserialized correctly, 
        ' display the key/value pairs.
        Dim de As DictionaryEntry
        For Each de In addresses
            Console.WriteLine("{0} lives at {1}.",
 de.Key, de.Value)
        Next
    End Sub
End Module
C#
using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization.Formatters.Binary;
using System.Runtime.Serialization;

public class App 
{
    [STAThread]
    static void Main() 
    {
        Serialize();
        Deserialize();
    }

    static void Serialize() 
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable and its key/value pairs,  
        // you must first open a stream for writing. 
        // In this case, use a file stream.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Create);

        // Construct a BinaryFormatter and use it to serialize the data
 to the stream.
        BinaryFormatter formatter = new BinaryFormatter();
        try 
        {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }
    }

   
    static void Deserialize() 
    {
        // Declare the hashtable reference.
        Hashtable addresses  = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Open);
        try 
        {
            BinaryFormatter formatter = new BinaryFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable) formatter.Deserialize(fs);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs.
        foreach (DictionaryEntry de in addresses)
 
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}
C++
using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization::Formatters::Binary;
using namespace System::Runtime::Serialization;
ref class App
{
public:
   static void Serialize()
   {
      
      // Create a hashtable of values that will eventually be serialized.
      Hashtable^ addresses = gcnew Hashtable;
      addresses->Add( "Jeff", "123 Main Street, Redmond, WA 98052"
 );
      addresses->Add( "Fred", "987 Pine Road, Phila., PA 19116"
 );
      addresses->Add( "Mary", "PO Box 112233, Palo Alto, CA 94301"
 );
      
      // To serialize the hashtable (and its keys/values),  
      // you must first open a stream for writing. 
      // In this case we will use a file stream.
      FileStream^ fs = gcnew FileStream( "DataFile.dat",FileMode::Create
 );
      
      // Construct a BinaryFormatter and use it to serialize the data
 to the stream.
      BinaryFormatter^ formatter = gcnew BinaryFormatter;
      try
      {
         formatter->Serialize( fs, addresses );
      }
      catch ( SerializationException^ e ) 
      {
         Console::WriteLine( "Failed to serialize. Reason: {0}", e->Message
 );
         throw;
      }
      finally
      {
         fs->Close();
      }

   }

   static void Deserialize()
   {
      
      // Declare the hashtable reference.
      Hashtable^ addresses = nullptr;
      
      // Open the file containing the data that we want to deserialize.
      FileStream^ fs = gcnew FileStream( "DataFile.dat",FileMode::Open
 );
      try
      {
         BinaryFormatter^ formatter = gcnew BinaryFormatter;
         
         // Deserialize the hashtable from the file and 
         // assign the reference to our local variable.
         addresses = dynamic_cast<Hashtable^>(formatter->Deserialize( fs
 ));
      }
      catch ( SerializationException^ e ) 
      {
         Console::WriteLine( "Failed to deserialize. Reason: {0}", e->Message
 );
         throw;
      }
      finally
      {
         fs->Close();
      }

      
      // To prove that the table deserialized correctly, display the
 keys/values.
      IEnumerator^ myEnum = addresses->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         DictionaryEntry ^ de = safe_cast<DictionaryEntry ^>(myEnum->Current);
         Console::WriteLine( " {0} lives at {1}.", de->Key, de->Value
 );
      }
   }

};


[STAThread]
int main()
{
   App::Serialize();
   App::Deserialize();
   return 0;
}
J#
import System.*;
import System.IO.*;
import System.Collections.*;
import System.Runtime.Serialization.Formatters.Binary.*;
import System.Runtime.Serialization.*;

public class App
{
    /** @attribute STAThread()
     */
    public static void main(String[]
 args) throws SerializationException
    {
        Serialize();
        Deserialize();
    } //main

    static void Serialize() throws SerializationException
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();

        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable and its key/value pairs,  
        // you must first open a stream for writing. 
        // In this case, use a file stream.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Create);

        // Construct a BinaryFormatter and use it to serialize the data
 to the 
        // stream.
        BinaryFormatter formatter = new BinaryFormatter();

        try {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to serialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
    } //Serialize

    static void Deserialize() throws SerializationException
    {
        // Declare the hashtable reference.
        Hashtable addresses = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Open);

        try {
            BinaryFormatter formatter = new BinaryFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable)(formatter.Deserialize(fs));
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to deserialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs.
        IEnumerator objEnum = addresses.GetEnumerator();
        while (objEnum.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)objEnum.get_Current();        
            Console.WriteLine("{0} lives at {1}.", de.get_Key(), 
                de.get_Value());
        }
    } //Deserialize
} //App
継承階層継承階層
System.Object
  System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

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、1.0
参照参照
関連項目
BinaryFormatter メンバ
System.Runtime.Serialization.Formatters.Binary 名前空間

BinaryFormatter コンストラクタ ()

BinaryFormatter クラスの新しいインスタンスを既定値で初期化します。

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New BinaryFormatter
C#
public BinaryFormatter ()
C++
public:
BinaryFormatter ()
J#
public BinaryFormatter ()
JScript
public function BinaryFormatter ()
解説解説

このコンストラクタは、次のように BinaryFormatter オブジェクトのプロパティを設定します。

プロパティの型

説明

SurrogateSelector

null 参照 (Visual Basic では Nothing)

Context

シリアル化されたデータを他の任意のコンテキストとの間で送受信できることを示す値を格納した StreamingContext。 (StreamingContextStates.All)

使用例使用例
Visual Basic
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization.Formatters.Binary
Imports System.Runtime.Serialization


Module App

    Sub Main()
        Serialize()
        Deserialize()
    End Sub

    Sub Serialize()

        ' Create a hashtable of values that will eventually be serialized.
        Dim addresses As New
 Hashtable
        addresses.Add("Jeff", "123
 Main Street, Redmond, WA 98052")
        addresses.Add("Fred", "987
 Pine Road, Phila., PA 19116")
        addresses.Add("Mary", "PO
 Box 112233, Palo Alto, CA 94301")

        ' To serialize the hashtable (and its key/value pairs),  
        ' you must first open a stream for writing. 
        ' In this case, use a file stream.
        Dim fs As New FileStream("DataFile.dat",
 FileMode.Create)

        ' Construct a BinaryFormatter and use it to serialize the data
 to the stream.
        Dim formatter As New
 BinaryFormatter
        Try
            formatter.Serialize(fs, addresses)
        Catch e As SerializationException
            Console.WriteLine("Failed to serialize. Reason: "
 & e.Message)
            Throw
        Finally
            fs.Close()
        End Try
    End Sub



    Sub Deserialize()
        ' Declare the hashtable reference.
        Dim addresses As Hashtable = Nothing

        ' Open the file containing the data that you want to deserialize.
        Dim fs As New FileStream("DataFile.dat",
 FileMode.Open)
        Try
            Dim formatter As New
 BinaryFormatter

            ' Deserialize the hashtable from the file and 
            ' assign the reference to the local variable.
            addresses = DirectCast(formatter.Deserialize(fs),
 Hashtable)
        Catch e As SerializationException
            Console.WriteLine("Failed to deserialize. Reason:
 " & e.Message)
            Throw
        Finally
            fs.Close()
        End Try

        ' To prove that the table deserialized correctly, 
        ' display the key/value pairs.
        Dim de As DictionaryEntry
        For Each de In addresses
            Console.WriteLine("{0} lives at {1}.",
 de.Key, de.Value)
        Next
    End Sub
End Module
C#
using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization.Formatters.Binary;
using System.Runtime.Serialization;

public class App 
{
    [STAThread]
    static void Main() 
    {
        Serialize();
        Deserialize();
    }

    static void Serialize() 
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable and its key/value pairs,  
        // you must first open a stream for writing. 
        // In this case, use a file stream.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Create);

        // Construct a BinaryFormatter and use it to serialize the data
 to the stream.
        BinaryFormatter formatter = new BinaryFormatter();
        try 
        {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }
    }

   
    static void Deserialize() 
    {
        // Declare the hashtable reference.
        Hashtable addresses  = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Open);
        try 
        {
            BinaryFormatter formatter = new BinaryFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable) formatter.Deserialize(fs);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs.
        foreach (DictionaryEntry de in addresses)
 
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}
C++
using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization::Formatters::Binary;
using namespace System::Runtime::Serialization;
ref class App
{
public:
   static void Serialize()
   {
      
      // Create a hashtable of values that will eventually be serialized.
      Hashtable^ addresses = gcnew Hashtable;
      addresses->Add( "Jeff", "123 Main Street, Redmond, WA 98052"
 );
      addresses->Add( "Fred", "987 Pine Road, Phila., PA 19116"
 );
      addresses->Add( "Mary", "PO Box 112233, Palo Alto, CA 94301"
 );
      
      // To serialize the hashtable (and its keys/values),  
      // you must first open a stream for writing. 
      // In this case we will use a file stream.
      FileStream^ fs = gcnew FileStream( "DataFile.dat",FileMode::Create
 );
      
      // Construct a BinaryFormatter and use it to serialize the data
 to the stream.
      BinaryFormatter^ formatter = gcnew BinaryFormatter;
      try
      {
         formatter->Serialize( fs, addresses );
      }
      catch ( SerializationException^ e ) 
      {
         Console::WriteLine( "Failed to serialize. Reason: {0}", e->Message
 );
         throw;
      }
      finally
      {
         fs->Close();
      }

   }

   static void Deserialize()
   {
      
      // Declare the hashtable reference.
      Hashtable^ addresses = nullptr;
      
      // Open the file containing the data that we want to deserialize.
      FileStream^ fs = gcnew FileStream( "DataFile.dat",FileMode::Open
 );
      try
      {
         BinaryFormatter^ formatter = gcnew BinaryFormatter;
         
         // Deserialize the hashtable from the file and 
         // assign the reference to our local variable.
         addresses = dynamic_cast<Hashtable^>(formatter->Deserialize( fs
 ));
      }
      catch ( SerializationException^ e ) 
      {
         Console::WriteLine( "Failed to deserialize. Reason: {0}", e->Message
 );
         throw;
      }
      finally
      {
         fs->Close();
      }

      
      // To prove that the table deserialized correctly, display the
 keys/values.
      IEnumerator^ myEnum = addresses->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         DictionaryEntry ^ de = safe_cast<DictionaryEntry ^>(myEnum->Current);
         Console::WriteLine( " {0} lives at {1}.", de->Key, de->Value
 );
      }
   }

};


[STAThread]
int main()
{
   App::Serialize();
   App::Deserialize();
   return 0;
}
J#
import System.*;
import System.IO.*;
import System.Collections.*;
import System.Runtime.Serialization.Formatters.Binary.*;
import System.Runtime.Serialization.*;

public class App
{
    /** @attribute STAThread()
     */
    public static void main(String[]
 args) throws SerializationException
    {
        Serialize();
        Deserialize();
    } //main

    static void Serialize() throws SerializationException
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();

        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable and its key/value pairs,  
        // you must first open a stream for writing. 
        // In this case, use a file stream.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Create);

        // Construct a BinaryFormatter and use it to serialize the data
 to the 
        // stream.
        BinaryFormatter formatter = new BinaryFormatter();

        try {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to serialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
    } //Serialize

    static void Deserialize() throws SerializationException
    {
        // Declare the hashtable reference.
        Hashtable addresses = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.dat",
 FileMode.Open);

        try {
            BinaryFormatter formatter = new BinaryFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable)(formatter.Deserialize(fs));
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to deserialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs.
        IEnumerator objEnum = addresses.GetEnumerator();
        while (objEnum.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)objEnum.get_Current();        
            Console.WriteLine("{0} lives at {1}.", de.get_Key(), 
                de.get_Value());
        }
    } //Deserialize
} //App
プラットフォームプラットフォーム

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、1.0
参照参照
関連項目
BinaryFormatter クラス
BinaryFormatter メンバ
System.Runtime.Serialization.Formatters.Binary 名前空間

BinaryFormatter コンストラクタ (ISurrogateSelector, StreamingContext)

サロゲート セレクタおよびストリーム コンテキストを指定して、BinaryFormatter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    selector As ISurrogateSelector, _
    context As StreamingContext _
)
Visual Basic (使用法)
Dim selector As ISurrogateSelector
Dim context As StreamingContext

Dim instance As New BinaryFormatter(selector,
 context)
C#
public BinaryFormatter (
    ISurrogateSelector selector,
    StreamingContext context
)
C++
public:
BinaryFormatter (
    ISurrogateSelector^ selector, 
    StreamingContext context
)
J#
public BinaryFormatter (
    ISurrogateSelector selector, 
    StreamingContext context
)
JScript
public function BinaryFormatter (
    selector : ISurrogateSelector, 
    context : StreamingContext
)

パラメータ

selector

使用する ISurrogateSelector。null 参照 (Visual Basic では Nothing) でもかまいません。

context

シリアル化されたデータの転送元と転送先。

解説解説

指定した Stream からオブジェクトをシリアル化または逆シリアル化するための新しい BinaryFormatter を初期化します。

シリアル化処理または逆シリアル化処理では、指定した ISurrogateSelector を使用して、逆シリアル化するオブジェクト型用に登録されているサロゲートを検索します。サロゲートは、特定のクラスのオブジェクトをシリアル化および逆シリアル化するためのヘルパです。既定の ISurrogateSelector では、MarshalByRefObject から派生したオブジェクトをリモート処理の目的でシリアル化することはできません。リモート処理を行う場合は、指定した ISurrogateSelector が、MarshalByRefObject から派生したオブジェクトを、指定したサロゲート セレクタによってシリアル化された ObjRef オブジェクトに置換します。つまり、リモート オブジェクトを使用する場合は、selector パラメータに RemotingSurrogateSelector のインスタンスを設定します。サロゲートが不要な場合は、selector パラメータを null 参照 (Visual Basic では Nothing) に設定します。

プラットフォームプラットフォーム

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、1.0
参照参照
関連項目
BinaryFormatter クラス
BinaryFormatter メンバ
System.Runtime.Serialization.Formatters.Binary 名前空間

BinaryFormatter コンストラクタ

BinaryFormatter クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
BinaryFormatter () BinaryFormatter クラスの新しいインスタンスを既定値で初期化します。
BinaryFormatter (ISurrogateSelector, StreamingContext) サロゲート セレクタおよびストリーム コンテキストを指定して、BinaryFormatter クラスの新しいインスタンスを初期化します。
参照参照

関連項目

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

BinaryFormatter プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ AssemblyFormat アセンブリの検索と読み込みに関するデシリアライザの動作を取得または設定します。
パブリック プロパティ Binder シリアル化されたオブジェクトから型へのバインディングを制御する、SerializationBinder 型のオブジェクトを取得または設定します。
パブリック プロパティ Context 対象のフォーマッタで使用する StreamingContext を取得または設定します。
パブリック プロパティ FilterLevel BinaryFormatter が実行する自動逆シリアル化の TypeFilterLevel を取得または設定します。
パブリック プロパティ SurrogateSelector シリアル化中および逆シリアル化中に行われる型の置換を制御する ISurrogateSelector を取得または設定します。
パブリック プロパティ TypeFormat シリアル化されたストリームにおける型の記述のレイアウト形式を取得または設定します。
参照参照

関連項目

BinaryFormatter クラス
System.Runtime.Serialization.Formatters.Binary 名前空間

BinaryFormatter メソッド


パブリック メソッドパブリック メソッド

  名前 説明
パブリック メソッド Deserialize オーバーロードされます。 ストリームをオブジェクト グラフに逆シリアル化します。
パブリック メソッド DeserializeMethodResponse 指定した Stream から、リモート メソッド呼び出しへの応答を逆シリアル化します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Serialize オーバーロードされます。 オブジェクト、または連結された複数のオブジェクトから成るグラフを、指定したストリームにシリアル化します。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
パブリック メソッド UnsafeDeserialize 指定したストリームをオブジェクト グラフに逆シリアル化します。そのストリーム内にヘッダーがある場合は、指定した HeaderHandler がそのヘッダーを処理します。
パブリック メソッド UnsafeDeserializeMethodResponse 指定した Stream から、リモート メソッド呼び出しへの応答を逆シリアル化します。
参照参照

関連項目

BinaryFormatter クラス
System.Runtime.Serialization.Formatters.Binary 名前空間

BinaryFormatter メンバ

オブジェクト、または連結された複数のオブジェクトから成るグラフ全体を、バイナリ形式でシリアル化および逆シリアル化します。

BinaryFormatter データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド BinaryFormatter オーバーロードされます。 BinaryFormatter クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ AssemblyFormat アセンブリの検索と読み込みに関するデシリアライザの動作を取得または設定します。
パブリック プロパティ Binder シリアル化されたオブジェクトから型へのバインディングを制御する、SerializationBinder 型のオブジェクトを取得または設定します。
パブリック プロパティ Context 対象のフォーマッタで使用する StreamingContext を取得または設定します。
パブリック プロパティ FilterLevel BinaryFormatter が実行する自動逆シリアル化の TypeFilterLevel を取得または設定します。
パブリック プロパティ SurrogateSelector シリアル化中および逆シリアル化中に行われる型の置換を制御する ISurrogateSelector を取得または設定します。
パブリック プロパティ TypeFormat シリアル化されたストリームにおける型の記述のレイアウト形式を取得または設定します。
パブリック メソッドパブリック メソッド
  名前 説明
パブリック メソッド Deserialize オーバーロードされます。 ストリームをオブジェクト グラフに逆シリアル化します。
パブリック メソッド DeserializeMethodResponse 指定した Stream から、リモート メソッド呼び出しへの応答を逆シリアル化します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド Serialize オーバーロードされます。 オブジェクト、または連結された複数のオブジェクトから成るグラフを、指定したストリームにシリアル化します。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
パブリック メソッド UnsafeDeserialize 指定したストリームをオブジェクト グラフに逆シリアル化します。そのストリーム内にヘッダーがある場合は、指定した HeaderHandler がそのヘッダーを処理します。
パブリック メソッド UnsafeDeserializeMethodResponse 指定した Stream から、リモート メソッド呼び出しへの応答を逆シリアル化します。
参照参照

関連項目

BinaryFormatter クラス
System.Runtime.Serialization.Formatters.Binary 名前空間

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「BinaryFormatter」の関連用語

1
BinaryFormatter.Deserialize メソッド
.NET Framework クラス ライブラリ リファレンス
94% |||||

2
BinaryFormatter.Serialize メソッド
.NET Framework クラス ライブラリ リファレンス
76% |||||

3
System.Runtime.Serialization.Formatters.Binary 名前空間
.NET Framework クラス ライブラリ リファレンス
72% |||||

4
RemotingSurrogateSelector プロパティ
.NET Framework クラス ライブラリ リファレンス
58% |||||

5
BinaryFormatter コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
54% |||||

6
BinaryFormatter クラス
.NET Framework クラス ライブラリ リファレンス
50% |||||

7
BinaryClientFormatterSinkProvider プロパティ
.NET Framework クラス ライブラリ リファレンス
50% |||||

8
BinaryFormatter.FilterLevel プロパティ
.NET Framework クラス ライブラリ リファレンス
50% |||||

9
DesignerSerializationManager イベント
.NET Framework クラス ライブラリ リファレンス
50% |||||

10
OnDeserializedAttribute プロパティ
.NET Framework クラス ライブラリ リファレンス
50% |||||

BinaryFormatterのお隣キーワード

BinaryEditor コンストラクタ

BinaryEditor プロパティ

BinaryEditor メソッド

BinaryEditor メンバ

BinaryEditor.EditValue メソッド

BinaryEditor.GetEditStyle メソッド

BinaryFormatter

BinaryFormatter クラス

BinaryFormatter コンストラクタ ()

BinaryFormatter プロパティ

BinaryFormatter メソッド

BinaryFormatter メンバ

BinaryFormatter.AssemblyFormat プロパティ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


BinaryFormatterのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS