XmlReader.IsStartElement Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Проверяет, является ли текущий узел содержимого тегом запуска.

Перегрузки

Имя	Описание
IsStartElement(String, String)	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента, а также если LocalNameNamespaceURI найденные свойства элемента соответствуют заданным строкам.
IsStartElement()	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента.
IsStartElement(String)	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента, и если Name свойство элемента найдено соответствует заданному аргументу.

IsStartElement(String, String)

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

XmlReader.cs

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

public:
 virtual bool IsStartElement(System::String ^ localname, System::String ^ ns);

public virtual bool IsStartElement(string localname, string ns);

abstract member IsStartElement : string * string -> bool
override this.IsStartElement : string * string -> bool

Public Overridable Function IsStartElement (localname As String, ns As String) As Boolean

Параметры

localname

String

Строка, соответствующая LocalName свойству найденного элемента.

ns

String

Строка, соответствующая NamespaceURI свойству найденного элемента.

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

Boolean

true Значение , если результирующий узел является элементом. false Значение , если тип узла, отличный от XmlNodeType.Element найденного, или если LocalNameNamespaceURI свойства элемента не соответствуют указанным строкам.

Исключения

XmlException

В входном потоке обнаружен неправильный XML- код.

InvalidOperationException

Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

Комментарии

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

См. также раздел

• MoveToContent()

IsStartElement()

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

XmlReader.cs

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

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement();

abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool

Public Overridable Function IsStartElement () As Boolean

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

Boolean

trueЗначение , если находит тег начала или пустой тег элемента; MoveToContent() если false тип узла, отличный XmlNodeType.Element от найденного.

Исключения

XmlException

В входном потоке обнаружен неправильный XML- код.

InvalidOperationException

Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

Примеры

В следующем примере отображается текстовое содержимое каждого элемента.

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
                {
                    Console.WriteLine("<{0}/>", reader.Name);
                }
                else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  }
}

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

В этом примере файл elems.xmlиспользуется в качестве входных данных.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Комментарии

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

См. также раздел

• MoveToContent()

IsStartElement(String)

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

XmlReader.cs

Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента, и если Name свойство элемента найдено соответствует заданному аргументу.

public:
 virtual bool IsStartElement(System::String ^ name);

public virtual bool IsStartElement(string name);

abstract member IsStartElement : string -> bool
override this.IsStartElement : string -> bool

Public Overridable Function IsStartElement (name As String) As Boolean

Параметры

name

String

Строка, Name соответствующая свойству найденного элемента.

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

Boolean

true Значение , если результирующий узел является элементом, а Name свойство соответствует указанной строке. false Значение , если тип узла, отличный XmlNodeType.Element от найденного, или если свойство элемента Name не соответствует указанной строке.

Исключения

XmlException

В входном потоке обнаружен неправильный XML- код.

InvalidOperationException

Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

Примеры

В следующем примере отображается каждый элемент price.

// Parse the file and display each price node.
while (reader.Read()) {
  if (reader.IsStartElement("price")) {
     Console.WriteLine(reader.ReadInnerXml());
  }
}

' Parse the file and display each price node.
While reader.Read()
  If reader.IsStartElement("price") Then
    Console.WriteLine(reader.ReadInnerXml())
  End If
End While

Комментарии

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

См. также раздел

• MoveToContent()