SurrogateSelector SurrogateSelector SurrogateSelector SurrogateSelector Class

定義

在序列化 (Serialization) 代理的選取方面協助格式子 (Formatter),以委派 (Delegate) 序列化或還原序列化 (Deserialization) 處理序。Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

public ref class SurrogateSelector : System::Runtime::Serialization::ISurrogateSelector
[System.Runtime.InteropServices.ComVisible(true)]
public class SurrogateSelector : System.Runtime.Serialization.ISurrogateSelector
type SurrogateSelector = class
    interface ISurrogateSelector
Public Class SurrogateSelector
Implements ISurrogateSelector
繼承
SurrogateSelectorSurrogateSelectorSurrogateSelectorSurrogateSelector
衍生
屬性
實作

範例

下列程式碼範例示範如何讓知道如何正確地序列化或還原序列化的類別,不是其本身的序列化 surrogate 類別可序列化。The following code example shows how to make a serialization surrogate class that knows how to properly serialize or deserialize a class that is not itself serializable. 此外,此範例也顯示如何從復原SerializationExceptionIn addition, this example also shows how to recover from a SerializationException.

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters;
using System.Runtime.Serialization.Formatters.Binary;


// This class is not serializable.
class Employee 
    {
    public String name, address;

    public Employee(String name, String address) 
    {
        this.name = name;
        this.address = address;
    }
}

// This class can manually serialize an Employee object.
sealed class EmployeeSerializationSurrogate : ISerializationSurrogate 
{

    // Serialize the Employee object to save the object's name and address fields.
    public void GetObjectData(Object obj, 
        SerializationInfo info, StreamingContext context) 
    {

        var emp = (Employee) obj;
        info.AddValue("name", emp.name);
        info.AddValue("address", emp.address);
    }

    // Deserialize the Employee object to set the object's name and address fields.
    public Object SetObjectData(Object obj,
        SerializationInfo info, StreamingContext context,
        ISurrogateSelector selector) 
    {

        var emp = (Employee) obj;
        emp.name = info.GetString("name");
        emp.address = info.GetString("address");
        return emp;
    }
}

public sealed class App 
{
    static void Main() 
    {
        // This sample uses the BinaryFormatter.
        IFormatter formatter = new BinaryFormatter();

        // Create a MemoryStream that the object will be serialized into and deserialized from.
        using (Stream stream = new MemoryStream()) 
        {
            // Create a SurrogateSelector.
            var ss = new SurrogateSelector();

            // Tell the SurrogateSelector that Employee objects are serialized and deserialized 
            // using the EmployeeSerializationSurrogate object.
            ss.AddSurrogate(typeof(Employee),
            new StreamingContext(StreamingContextStates.All),
            new EmployeeSerializationSurrogate());

            // Associate the SurrogateSelector with the BinaryFormatter.
            formatter.SurrogateSelector = ss;

            try 
            {
                // Serialize an Employee object into the memory stream.
                formatter.Serialize(stream, new Employee("Jeff", "1 Microsoft Way"));
            }
            catch (SerializationException e) 
            {
                Console.WriteLine("Serialization failed: {0}", e.Message);
                throw;
            }

            // Rewind the MemoryStream.
            stream.Position = 0;

            try 
            {
                // Deserialize the Employee object from the memory stream.
                var emp = (Employee) formatter.Deserialize(stream);

                // Verify that it all worked.
                Console.WriteLine("Name = {0}, Address = {1}", emp.name, emp.address);
            }
            catch (SerializationException e) 
            {
                Console.WriteLine("Deserialization failed: {0}", e.Message);
                throw;
            }
        }
    }
}

// This code produces the following output.
//
// Name = Jeff, Address = 1 Microsoft Way

備註

序列化代理提供使用者的物件,可處理不同物件的序列化需求,並可以在必要時轉換序列化的資料。A serialization surrogate gives the users an object that can handle the serialization requirements of a different object and can transform the serialized data if necessary.

建構函式

SurrogateSelector() SurrogateSelector() SurrogateSelector() SurrogateSelector()

初始化 SurrogateSelector 類別的新執行個體。Initializes a new instance of the SurrogateSelector class.

方法

AddSurrogate(Type, StreamingContext, ISerializationSurrogate) AddSurrogate(Type, StreamingContext, ISerializationSurrogate) AddSurrogate(Type, StreamingContext, ISerializationSurrogate) AddSurrogate(Type, StreamingContext, ISerializationSurrogate)

將代理加入至已檢查代理的清單中。Adds a surrogate to the list of checked surrogates.

ChainSelector(ISurrogateSelector) ChainSelector(ISurrogateSelector) ChainSelector(ISurrogateSelector) ChainSelector(ISurrogateSelector)

將可以控制特定物件型別的指定 ISurrogateSelector 加入至代理清單。Adds the specified ISurrogateSelector that can handle a particular object type to the list of surrogates.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetNextSelector() GetNextSelector() GetNextSelector() GetNextSelector()

傳回在選取器鏈結上的下一個選取器。Returns the next selector on the chain of selectors.

GetSurrogate(Type, StreamingContext, ISurrogateSelector) GetSurrogate(Type, StreamingContext, ISurrogateSelector) GetSurrogate(Type, StreamingContext, ISurrogateSelector) GetSurrogate(Type, StreamingContext, ISurrogateSelector)

傳回特定型別的代理。Returns the surrogate for a particular type.

GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveSurrogate(Type, StreamingContext) RemoveSurrogate(Type, StreamingContext) RemoveSurrogate(Type, StreamingContext) RemoveSurrogate(Type, StreamingContext)

移除與指定型別相關聯的代理。Removes the surrogate associated with a given type.

ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)

適用於