내보내기(0) 인쇄
모두 확장

BinaryFormatter 클래스

업데이트: 2007년 11월

개체나 연결된 개체의 전체 그래프를 이진 형식으로 serialize 및 deserialize합니다.

네임스페이스:  System.Runtime.Serialization.Formatters.Binary
어셈블리:  mscorlib(mscorlib.dll)

[ComVisibleAttribute(true)]
public sealed class BinaryFormatter : IRemotingFormatter, 
	IFormatter
/** @attribute ComVisibleAttribute(true) */
public final class BinaryFormatter implements IRemotingFormatter, 
	IFormatter
public final class BinaryFormatter implements IRemotingFormatter, IFormatter

SoapFormatterBinaryFormatter 클래스는 IRemotingFormatter 인터페이스를 구현하여 RPC(원격 프로시저 호출)를 지원하고, IRemotingFormatter에서 상속된 IFormatter 인터페이스를 구현하여 개체 그래프의 serialization을 지원합니다. 또한 SoapFormatter 클래스는 IRemotingFormatter 기능을 사용하지 않고 ISoapMessage 개체를 사용하여 RPC를 지원합니다.

RPC를 수행하는 동안 IRemotingFormatter 인터페이스를 사용하면 서로 다른 두 개체의 그래프, 즉 serialize할 개체의 그래프와 원격 함수 호출에 대한 정보(예: 트랜잭션 ID나 메서드 시그니처)를 전달할 헤더 개체의 배열이 포함된 그래프를 지정할 수 있습니다.

BinaryFormatter를 사용하는 RPC는 호출된 메서드를 포함하는 원격 개체와 함께 서버로 전송되는 메서드 호출과, 호출된 메서드의 상태 및 응답 정보와 함께 서버에서 클라이언트로 전송되는 메서드 응답으로 구분됩니다.

메서드 호출을 serialize하는 동안 개체 그래프의 첫째 개체는 IMethodCallMessage 인터페이스를 지원해야 합니다. 메서드 호출을 deserialize하려면 HeaderHandler 매개 변수와 함께 Deserialize 메서드를 사용합니다. 원격 인프라는 HeaderHandler 대리자를 사용하여 ISerializable 인터페이스를 지원하는 개체를 만듭니다. BinaryFormatter에서 HeaderHandler 대리자를 호출하면 호출되는 메서드와 함께 원격 개체의 URI가 반환됩니다. 반환되는 그래프의 첫째 개체는 IMethodCallMessage 인터페이스를 지원합니다.

메서드 응답에 대한 serialization 프로시저는 개체 그래프의 첫 번째 개체가 IMethodReturnMessage 인터페이스를 지원해야 한다는 점을 제외하고는 메서드 호출의 serialization 프로시저와 동일합니다. 메서드 응답을 deserialize하려면 DeserializeMethodResponse 메서드를 사용합니다. 시간을 절약하기 위해 메서드 호출 동안 호출자 개체에 대한 세부 사항이 원격 개체로 보내지지 않습니다. 대신 이러한 세부 사항은 IMethodCallMessage 매개 변수의 DeserializeMethodResponse 메서드에 전달되는 원래 메서드 호출에서 가져옵니다. DeserializeMethodResponse 메서드가 반환하는 그래프의 첫째 개체는 IMethodReturnMessage 인터페이스를 지원합니다.

짝이 없는 서로게이트

짝이 없는 서로게이트 문자는 이진 serialization을 수행할 때 손실됩니다. 예를 들어, 다음 문자열에서 두 단어 Test 사이에는 high surrogate 유니코드 문자(\ud800)가 들어 있습니다.

Test\ud800Test

serialization 전의 문자열 바이트 배열은 다음과 같습니다.

바이트 배열 값

문자

84

T

101

e

115

s

116

t

55296

\ud800

84

T

101

e

115

s

116

t

deserialization 후 high surrogate 유니코드 문자는 다음과 같이 손실됩니다.

바이트 배열 값

문자

84

T

101

e

115

s

116

t

84

T

101

e

115

s

116

t

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);
        }
    }
}


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

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0, 2.0, 1.1, 1.0에서 지원

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft