BinaryFormatter クラス
オブジェクト、または連結された複数のオブジェクトから成るグラフ全体を、バイナリ形式でシリアル化および逆シリアル化します。 名前空間: System.Runtime.Serialization.Formatters.Binary
アセンブリ: mscorlib (mscorlib.dll 内)
構文
解説
使用例
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: mscorlib (mscorlib.dll 内)
構文<ComVisibleAttribute(True)> _ Public NotInheritable Class BinaryFormatter Implements IRemotingFormatter, IFormatter
[ComVisibleAttribute(true)] public ref class BinaryFormatter sealed : 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 インターフェイスをサポートしています。
対になっていないサロゲート使用例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
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); } } }
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; }
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
System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- BinaryFormatter クラスのページへのリンク
