XmlObjectSerializer.IsStartObject Метод

Определение

Возвращает значение, указывающее, может ли сериализатор выполнить чтение объекта.Gets a value that specifies whether the serializer can read the object.

Перегрузки

IsStartObject(XmlDictionaryReader)

Возвращает значение, указывающее, расположено ли средство чтения XmlDictionaryReader на элементе XML, который можно считать.Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that can be read.

IsStartObject(XmlReader)

Возвращает значение, указывающее, расположено ли средство чтения XmlReader на элементе XML, который можно считать.Gets a value that specifies whether the XmlReader is positioned over an XML element that can be read.

Комментарии

Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе.This method checks whether the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. Значение true возвращается при условии, что найденный элемент имеет ожидаемое имя.To return true, the found element must have an expected name. Фактическое ожидаемое имя элемента зависит от реализации сериализатора.The actual expected element name depends on the implementation of the serializer.

При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения.With the DataContractSerializer, the starting element is specified in the constructor of the extension class. В качестве примера см. конструкторы класса DataContractSerializer.For an example, see the constructors for the DataContractSerializer class.

IsStartObject(XmlDictionaryReader)

Возвращает значение, указывающее, расположено ли средство чтения XmlDictionaryReader на элементе XML, который можно считать.Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that can be read.

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-документа.An XmlDictionaryReader used to read the XML stream or document.

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

Boolean

Значение true, если средство чтения может считать данные; в противном случае — значение false.true if the reader can read the data; otherwise, false.

Комментарии

Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе.This method checks if the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. Реализация метода XmlObjectSerializer определяет, когда возвращается значение true.The XmlObjectSerializer implementation determines when to return true. Реализации могут выполнить проверку, расположены ли они на элементе или осуществить поиск ожидаемого имени элемента.Implementations may check that they are positioned on an element or look for an expected element name. Одна реализация метода XmlObjectSerializer, реализация DataContractSerializer, проверяет, расположена ли она на элементе и является ли имя элемента ожидаемым именем верхнего уровня десериализуемого в данный момент типа.One implementation of the XmlObjectSerializer, the DataContractSerializer, checks that it is positioned on an element and also checks that the element name is the top level expected name for the type currently being deserialized.

При необходимости можно выполнить считывание дополнительных атрибутов из XML-потока, когда устройство чтения расположено на элементе верхнего уровня перед чтением содержимого XML с помощью метода ReadObject.If needed, additional attributes in the XML stream can be read while positioned on the top level element before reading XML contents using the ReadObject method.

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

IsStartObject(XmlReader)

Возвращает значение, указывающее, расположено ли средство чтения XmlReader на элементе XML, который можно считать.Gets a value that specifies whether the XmlReader is positioned over an XML element that can be read.

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-документа.An XmlReader used to read the XML stream or document.

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

Boolean

Значение true, если средство чтения расположено на начальном элементе; в противном случае — значение false.true if the reader is positioned over the starting element; otherwise, false.

Комментарии

Этот метод проверяет, расположено ли средство чтения на считываемом элементе, и возвращает значение true, если элемент является элементом верхнего уровня для объекта в XML-потоке или XML-документе.This method checks whether the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. Значение true возвращается при условии, что найденный элемент имеет ожидаемое имя.To return true, the found element must have an expected name. Фактическое ожидаемое имя элемента зависит от реализации сериализатора.The actual expected element name depends on the implementation of the serializer.

При использовании метода DataContractSerializer начальный элемент задается в конструкторе класса расширения.With the DataContractSerializer, the starting element is specified in the constructor of the extension class. В качестве примера см. конструкторы класса DataContractSerializer.For an example, see the constructors for the DataContractSerializer class.

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