DataContractJsonSerializer Класс

Определение

Сериализует объекты в нотации объектов JavaScript (JSON) и десериализирует данные JSON в объекты. Этот класс не наследуется.

public ref class DataContractJsonSerializer sealed
public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
type DataContractJsonSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
Наследование
DataContractJsonSerializer
Наследование
DataContractJsonSerializer

Комментарии

В большинстве сценариев, связанных с сериализированием в JSON и десериализацией из JSON, рекомендуется использовать API в пространстве имен System.Text.Json.

Если для сценария требуется DataContractJsonSerializer класс, его можно использовать для сериализации экземпляров типа в документ JSON и десериализации документа JSON в экземпляр типа. Например, вы можете создать тип с именем Person и свойствами, содержащими важные данные, такие как имя и адрес. Затем можно создать и управлять экземпляром Person класса и записать все его значения свойств в документ JSON для последующего извлечения. Этот документ JSON позже можно десериализировать в Person класс или другой класс с эквивалентным контрактом данных.

Если ошибка возникает во время сериализации исходящего ответа на сервере или операция ответа вызывает исключение по какой-либо другой причине, он не может вернуться клиенту в качестве ошибки.

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

Имя Описание
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа и параметров сериализатора.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа. Этот метод также указывает список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, независимо от того, следует ли игнорировать непредвиденные данные или выдавать сведения о типе, а также суррогат для пользовательской сериализации.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа с коллекцией известных типов, которые могут присутствовать в графе объектов.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа. Этот метод также указывает корневое имя XML-элемента, список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, независимо от того, следует ли игнорировать непредвиденные данные или выдавать сведения о типе, а также суррогат для пользовательской сериализации.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа с использованием корневого XML-элемента, указанного параметром, с коллекцией известных типов, которые могут присутствовать в графе объектов.

DataContractJsonSerializer(Type, String)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа с помощью корневого XML-элемента, указанного параметром.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа. Этот метод также указывает корневое имя XML-элемента, список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, независимо от того, следует ли игнорировать непредвиденные данные или выдавать сведения о типе, а также суррогат для пользовательской сериализации.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, указанного параметром типа XmlDictionaryString, с коллекцией известных типов, которые могут присутствовать в графе объектов.

DataContractJsonSerializer(Type, XmlDictionaryString)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа с помощью корневого xml-элемента, указанного параметром типа XmlDictionaryString.

DataContractJsonSerializer(Type)

Инициализирует новый экземпляр DataContractJsonSerializer класса для сериализации или десериализации объекта указанного типа.

Свойства

Имя Описание
DataContractSurrogate

Возвращает суррогатный тип, который в настоящее время активен для данного IDataContractSurrogate экземпляра. Суррогаты могут расширить процесс сериализации или десериализации.

DateTimeFormat

Возвращает формат элементов типа даты и времени в графе объектов.

EmitTypeInformation

Возвращает или задает параметры сериализатора JSON контракта данных для выдачи сведений о типе.

IgnoreExtensionDataObject

Возвращает значение, указывающее, игнорируются ли неизвестные данные при десериализации и игнорируются ли IExtensibleDataObject интерфейс при сериализации.

KnownTypes

Возвращает коллекцию типов, которые могут присутствовать в графе объектов, сериализованном с помощью этого экземпляра DataContractJsonSerializerобъекта.

MaxItemsInObjectGraph

Возвращает максимальное количество элементов в графе объектов, которое сериализатор сериализует или десериализирует в одном вызове чтения или записи.

SerializeReadOnlyTypes

Возвращает или задает значение, указывающее, следует ли сериализовать только типы чтения.

UseSimpleDictionaryFormat

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

Методы

Имя Описание
Equals(Object)

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

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

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

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

Возвращает текущий суррогатный поставщик сериализации.

GetType()

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

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

Возвращает значение, указывающее, расположен ли XmlDictionaryReader элемент XML, представляющий объект сериализатора, может десериализировать из.

IsStartObject(XmlReader)

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

MemberwiseClone()

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

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

Считывает поток документов в формате JSON (нотация объектов JavaScript) и возвращает десериализированный объект.

ReadObject(XmlDictionaryReader, Boolean)

Считывает XML-документ, сопоставленный с JSON, XmlDictionaryReader и возвращает десериализированный объект. Он также позволяет указать, должен ли сериализатор убедиться, что он расположен на соответствующем элементе перед попыткой десериализации.

ReadObject(XmlDictionaryReader)

Считывает XML-документ, сопоставленный с JSON (нотация объектов JavaScript) XmlDictionaryReader и возвращает десериализированный объект.

ReadObject(XmlReader, Boolean)

Считывает XML-документ, сопоставленный с JSON, XmlReader и возвращает десериализированный объект; он также позволяет указать, должен ли сериализатор убедиться, что он расположен на соответствующем элементе перед попыткой десериализации.

ReadObject(XmlReader)

Считывает XML-документ, сопоставленный с JSON (нотация объектов JavaScript) XmlReader и возвращает десериализированный объект.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Задает суррогатный поставщик сериализации.

ToString()

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

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

Записывает закрывающий XML-элемент в XML-документ, используя XmlDictionaryWriterобъект, который можно сопоставить с нотацией объектов JavaScript (JSON).

WriteEndObject(XmlWriter)

Записывает закрывающий XML-элемент в XML-документ, используя XmlWriterобъект, который можно сопоставить с нотацией объектов JavaScript (JSON).

WriteObject(Stream, Object)

Сериализует указанный объект в данные нотации объектов JavaScript (JSON) и записывает полученный JSON в поток.

WriteObject(XmlDictionaryWriter, Object)

Сериализует объект в XML, который может быть сопоставлен с нотацией объектов JavaScript (JSON). Записывает все данные объекта, включая начальный XML-элемент, содержимое и закрывающий элемент с помощью XmlDictionaryWriterэлемента.

WriteObject(XmlWriter, Object)

Сериализует объект в XML, который может быть сопоставлен с нотацией объектов JavaScript (JSON). Записывает все данные объекта, включая начальный XML-элемент, содержимое и закрывающий элемент с помощью XmlWriterэлемента.

WriteObjectContent(XmlDictionaryWriter, Object)

Записывает XML-содержимое, которое можно сопоставить с нотацией объектов JavaScript (JSON) с помощью .XmlDictionaryWriter

WriteObjectContent(XmlWriter, Object)

Записывает XML-содержимое, которое можно сопоставить с нотацией объектов JavaScript (JSON) с помощью .XmlWriter

WriteStartObject(XmlDictionaryWriter, Object)

Записывает открывающий XML-элемент для сериализации объекта в XML, который можно сопоставить с нотацией XmlDictionaryWriterобъектов JavaScript (JSON).

WriteStartObject(XmlWriter, Object)

Записывает открывающий XML-элемент для сериализации объекта в XML, который можно сопоставить с нотацией XmlWriterобъектов JavaScript (JSON).

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