SurrogateSelector 類別

定義

在序列化 (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
繼承
SurrogateSelector
衍生
屬性
實作

範例

下列程式碼範例示範如何建立序列化代理類別,知道如何適當地序列化或還原序列化本身不是 serializable 的類別。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. 此外,此範例也會說明如何從 SerializationException復原。In 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 類別的新執行個體。Initializes a new instance of the SurrogateSelector class.

方法

AddSurrogate(Type, StreamingContext, ISerializationSurrogate)

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

ChainSelector(ISurrogateSelector)

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

Equals(Object)

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

(繼承來源 Object)
GetHashCode()

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

(繼承來源 Object)
GetNextSelector()

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

GetSurrogate(Type, StreamingContext, ISurrogateSelector)

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

GetType()

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

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
RemoveSurrogate(Type, StreamingContext)

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

ToString()

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

(繼承來源 Object)

適用於