XmlObjectSerializer.IsStartObject Метод

Определение

Пространство имен:

System.Runtime.Serialization

Сборка:

System.Runtime.Serialization.Xml.dll

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

Перегрузки

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

Комментарии

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

При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения. В качестве примера см. конструкторы класса DataContractSerializer.

IsStartObject(XmlDictionaryReader)

Исходный код:

XmlObjectSerializer.cs

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

public:
 abstract bool IsStartObject(System::Xml::XmlDictionaryReader ^ reader);

public abstract bool IsStartObject (System.Xml.XmlDictionaryReader reader);

abstract member IsStartObject : System.Xml.XmlDictionaryReader -> bool

Public MustOverride Function IsStartObject (reader As XmlDictionaryReader) As Boolean

Параметры

reader

XmlDictionaryReader

Средство чтения XmlDictionaryReader, используемое для чтения XML-потока или XML-документа.

Возвращаемое значение

Boolean

Значение true, если средство чтения может считать данные; в противном случае — значение false.

Комментарии

Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе. Реализация метода XmlObjectSerializer определяет, когда возвращается значение true. Реализации могут выполнить проверку, расположены ли они на элементе или осуществить поиск ожидаемого имени элемента. Одна реализация метода XmlObjectSerializer, реализация DataContractSerializer, проверяет, расположена ли она на элементе и является ли имя элемента ожидаемым именем верхнего уровня десериализуемого в данный момент типа.

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

IsStartObject(XmlReader)

Исходный код:

XmlObjectSerializer.cs

Возвращает значение, указывающее, расположено ли средство чтения 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 -> bool

Public Overridable Function IsStartObject (reader As XmlReader) As Boolean

Параметры

reader

XmlReader

Средство чтения XmlReader, используемое для чтения XML-потока или XML-документа.

Возвращаемое значение

Boolean

Значение true, если средство чтения расположено на начальном элементе; в противном случае — значение false.

Комментарии

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

При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения. В качестве примера см. конструкторы класса DataContractSerializer.