NetDataContractSerializer.ReadObject Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает XML-поток или документ и возвращает десериализованный объект.
Перегрузки
ReadObject(XmlReader) |
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект. |
ReadObject(XmlDictionaryReader, Boolean) |
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект; также проверяет, соответствуют ли данные объекта имени и пространству имен, используемым для создания сериализатора. |
ReadObject(XmlReader, Boolean) |
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект; также проверяет, соответствуют ли данные объекта имени и пространству имен, используемым для создания сериализатора. |
Комментарии
Важно!
Вызов этого метода для ненадежных данных представляет угрозу безопасности. Вызывайте этот метод только для надежных данных. Дополнительные сведения см. в разделе Проверка всех входных данных.
ReadObject(XmlReader)
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект.
public:
override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader);
public override object ReadObject (System.Xml.XmlReader reader);
override this.ReadObject : System.Xml.XmlReader -> obj
Public Overrides Function ReadObject (reader As XmlReader) As Object
Параметры
Возвращаемое значение
Десериализованный объект.
Исключения
параметру reader
задано значение null
.
Комментарии
Важно!
Вызов этого метода для ненадежных данных представляет угрозу безопасности. Вызывайте этот метод только для надежных данных. Дополнительные сведения см. в разделе Проверка всех входных данных.
Применяется к
ReadObject(XmlDictionaryReader, Boolean)
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект; также проверяет, соответствуют ли данные объекта имени и пространству имен, используемым для создания сериализатора.
public:
override System::Object ^ ReadObject(System::Xml::XmlDictionaryReader ^ reader, bool verifyObjectName);
public override object ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName);
override this.ReadObject : System.Xml.XmlDictionaryReader * bool -> obj
Public Overrides Function ReadObject (reader As XmlDictionaryReader, verifyObjectName As Boolean) As Object
Параметры
- reader
- XmlDictionaryReader
Средство чтения XmlDictionaryReader, используемое для чтения XML-потока или документа.
- verifyObjectName
- Boolean
true
, если требуется проверить соответствие имени и пространства имен включающего XML-элемента ожидаемым корневым имени и пространству имен, используемым для создания сериализатора; false
, если следует пропустить проверку.
Возвращаемое значение
Десериализованный объект.
Исключения
параметру reader
задано значение null
.
Комментарии
Параметр verifyObjectName
определяет, можно ли считать объект посредством проверки имени и пространства имен XML-элемента, на котором установлено средство чтения, и сравнения этих значений с ожидаемыми именем и пространством имен. Ожидаемые имя и пространство имен могут принимать следующие значения: имя и пространство имен контракта данных типа, переданного в конструктор, или значения rootName
и rootNamespace
, переданные в конструктор (при его наличии).
rootName
и rootNamespace
можно задать в следующих конструкторах: NetDataContractSerializer(String, String), NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) и NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector).
Важно!
Вызов этого метода для ненадежных данных представляет угрозу безопасности. Вызывайте этот метод только для надежных данных. Дополнительные сведения см. в разделе Проверка всех входных данных.
Применяется к
ReadObject(XmlReader, Boolean)
Считывает XML-поток или документ с помощью средства чтения XmlDictionaryReader и возвращает десериализованный объект; также проверяет, соответствуют ли данные объекта имени и пространству имен, используемым для создания сериализатора.
public:
override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader, bool verifyObjectName);
public override object ReadObject (System.Xml.XmlReader reader, bool verifyObjectName);
override this.ReadObject : System.Xml.XmlReader * bool -> obj
Public Overrides Function ReadObject (reader As XmlReader, verifyObjectName As Boolean) As Object
Параметры
- verifyObjectName
- Boolean
true
, если требуется проверить соответствие имени и пространства имен включающего XML-элемента ожидаемым корневым имени и пространству имен, используемым для создания сериализатора; false
, если следует пропустить проверку.
Возвращаемое значение
Десериализованный объект.
Исключения
параметру reader
задано значение null
.
Комментарии
Параметр verifyObjectName
определяет, можно ли считать объект посредством проверки имени и пространства имен XML-элемента, на котором установлено средство чтения, и сравнения этих значений с ожидаемыми именем и пространством имен. Ожидаемые имя и пространство имен могут принимать следующие значения: имя и пространство имен контракта данных типа, переданного в конструктор, или значения rootName
и rootNamespace
, переданные в конструктор (при его наличии).
rootName
и rootNamespace
можно задать в следующих конструкторах: NetDataContractSerializer(String, String), NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) и NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector).
Важно!
Вызов этого метода для ненадежных данных представляет угрозу безопасности. Вызывайте этот метод только для надежных данных. Дополнительные сведения см. в разделе Проверка всех входных данных.