XmlObjectSerializer.IsStartObject Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее, может ли сериализатор выполнить чтение объекта.
Перегрузки
| IsStartObject(XmlDictionaryReader) |
Возвращает значение, указывающее, расположено ли средство чтения XmlDictionaryReader на элементе XML, который можно считать. |
| IsStartObject(XmlReader) |
Возвращает значение, указывающее, расположено ли средство чтения XmlReader на элементе XML, который можно считать. |
Комментарии
Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе. Значение true возвращается при условии, что найденный элемент имеет ожидаемое имя. Фактическое ожидаемое имя элемента зависит от реализации сериализатора.
При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения. В качестве примера см. конструкторы класса DataContractSerializer.
IsStartObject(XmlDictionaryReader)
Возвращает значение, указывающее, расположено ли средство чтения XmlDictionaryReader на элементе XML, который можно считать.
public:
abstract bool IsStartObject(System::Xml::XmlDictionaryReader ^ reader);public abstract bool IsStartObject (System.Xml.XmlDictionaryReader reader);abstract member IsStartObject : System.Xml.XmlDictionaryReader -> boolPublic MustOverride Function IsStartObject (reader As XmlDictionaryReader) As BooleanПараметры
- reader
- XmlDictionaryReader
Средство чтения XmlDictionaryReader, используемое для чтения XML-потока или XML-документа.
Возвращаемое значение
Значение true, если средство чтения может считать данные; в противном случае — значение false.
Комментарии
Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе. Реализация метода XmlObjectSerializer определяет, когда возвращается значение true. Реализации могут выполнить проверку, расположены ли они на элементе или осуществить поиск ожидаемого имени элемента. Одна реализация метода XmlObjectSerializer, реализация DataContractSerializer, проверяет, расположена ли она на элементе и является ли имя элемента ожидаемым именем верхнего уровня десериализуемого в данный момент типа.
При необходимости можно выполнить считывание дополнительных атрибутов из XML-потока, когда устройство чтения расположено на элементе верхнего уровня перед чтением содержимого XML с помощью метода ReadObject.
Применяется к
IsStartObject(XmlReader)
Возвращает значение, указывающее, расположено ли средство чтения XmlReader на элементе XML, который можно считать.
public:
virtual bool IsStartObject(System::Xml::XmlReader ^ reader);public virtual bool IsStartObject (System.Xml.XmlReader reader);abstract member IsStartObject : System.Xml.XmlReader -> bool
override this.IsStartObject : System.Xml.XmlReader -> boolPublic Overridable Function IsStartObject (reader As XmlReader) As BooleanПараметры
Возвращаемое значение
Значение true, если средство чтения расположено на начальном элементе; в противном случае — значение false.
Комментарии
Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе. Значение true возвращается при условии, что найденный элемент имеет ожидаемое имя. Фактическое ожидаемое имя элемента зависит от реализации сериализатора.
При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения. В качестве примера см. конструкторы класса DataContractSerializer.