Прочитать на английском

Поделиться через


SoapFormatter Класс

Определение

Сериализует и десериализует объект или весь граф связанных объектов в формате SOAP.

public sealed class SoapFormatter : System.Runtime.Remoting.Messaging.IRemotingFormatter
Наследование
SoapFormatter
Реализации

Примеры

using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization;

// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
using System.Runtime.Serialization.Formatters.Soap;

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.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap", FileMode.Create);

        // Construct a SoapFormatter and use it
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        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.soap", FileMode.Open);
        try
        {
            SoapFormatter formatter = new SoapFormatter();

            // 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 to the console.
        foreach (DictionaryEntry de in addresses)
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0 этот класс устарел.

Предупреждение

Тип BinaryFormatter является небезопасным, и его безопасность нельзя обеспечить. Дополнительные сведения см. в статье Руководство по безопасности BinaryFormatter.

Классы SoapFormatter и BinaryFormatter реализуют IRemotingFormatter интерфейс для поддержки удаленных вызовов процедур (RPC) и IFormatter интерфейс (наследуемый IRemotingFormatter) для поддержки сериализации графа объектов . Класс SoapFormatter также поддерживает RPC с ISoapMessage объектами без использования функциональных возможностей IRemotingFormatter .

Во время RPC IRemotingFormatter интерфейс позволяет указать два отдельных графа объектов: граф объектов для сериализации и дополнительный граф, содержащий массив объектов заголовков, которые передают сведения о вызове удаленной функции (например, идентификатор транзакции или сигнатуру метода). Для правильной сериализации корневой объект первого графа должен быть объектом, реализующим интерфейс IMethodCallMessage или IMethodReturnMessage интерфейс .

Во время десериализации RPC HeaderHandler делегат указывается Deserialize методу модуля форматирования. Инфраструктура удаленного HeaderHandler взаимодействия использует делегат для создания объекта, поддерживающего ISerializable интерфейс . Этот объект содержит сведения, хранящиеся в заголовках, и становится корнем графа, возвращаемого десериализатором.

Также SoapFormatter может обрабатывать RPC, созданные с объектами ISoapMessage , реализующими интерфейс . Чтобы создать RPC без использования IRemotingFormatter функциональных возможностей, поместите объект, поддерживающий ISoapMessage интерфейс, в корне сериализуемого графа. Для десериализации созданного таким образом RPC в свойстве TopObject необходимо задать другой объект, который поддерживает ISoapMessage интерфейс и содержит соответствующие сведения об удаленном вызове.

Объекты TimeSpan сериализуются в соответствии со стандартом "Альтернатива" стандарта ISO 8601: 1998, раздел 5.5.3.2.1.

Конструкторы

SoapFormatter()

Инициализирует новый экземпляр класса SoapFormatter значениями свойств по умолчанию.

SoapFormatter(ISurrogateSelector, StreamingContext)

Инициализирует новый экземпляр класса SoapFormatter с заданными свойствами ISurrogateSelector и StreamingContext.

Свойства

AssemblyFormat

Получает или задает поведение десериализатора в части, касающейся поиска и загрузки сборок.

Binder

Получает или задает SerializationBinder, управляющий привязкой сериализованного объекта к типу.

Context

Получает или задает StreamingContext, используемый с SoapFormatter.

FilterLevel

Получает или задает TypeFilterLevel автоматической десериализации для удаленной инфраструктуры .NET Framework.

SurrogateSelector

Получает или задает SurrogateSelector, управляющий подстановкой типа при сериализации и десериализации.

TopObject

Получает или задает ISoapMessage, в которое десериализуется верхний объект SOAP.

TypeFormat

Получает или задает формат, в котором описания типов раскладываются в сериализованном потоке.

Методы

Deserialize(Stream)

Десериализует данные в предоставленный поток и воспроизводит граф объектов.

Deserialize(Stream, HeaderHandler)

Десериализует поток в граф объектов, при этом все заголовки в этом потоке обрабатываются заданным HeaderHandler.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Serialize(Stream, Object)

Сериализует объект или граф объектов с указанным корнем в заданный поток Stream.

Serialize(Stream, Object, Header[])

Сериализует объект или граф объектов с указанным корнем в заданный поток Stream в формате RPC (удаленный вызов процедур) протокола SOAP.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1