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
- Наследование
Комментарии
В большинстве сценариев, связанных с сериализированием в 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). |