XmlReader.IsStartElement Метод

Определение

Проверяет, является ли текущий узел содержимого открывающим тегом.Tests if the current content node is a start tag.

Перегрузки

IsStartElement(String, String)

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствуют ли значения свойств LocalName и NamespaceURI элемента заданным строкам.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the LocalName and NamespaceURI properties of the element found match the given strings.

IsStartElement()

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

IsStartElement(String)

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствует ли значение свойства Name элемента заданному аргументу.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

IsStartElement(String, String)

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствуют ли значения свойств LocalName и NamespaceURI элемента заданным строкам.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the LocalName and NamespaceURI properties of the element found match the given strings.

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 найденного элемента.The string to match against the LocalName property of the element found.

ns
String

Строка, которая противопоставляется значению свойства NamespaceURI найденного элемента.The string to match against the NamespaceURI property of the element found.

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

Boolean

Значение true, если полученный в результате узел является элементом.true if the resulting node is an element. Значение false, если обнаружен узел с типом, отличным от XmlNodeType.Element, или если свойства LocalName и NamespaceURI элемента не совпадают с указанными строками.false if a node type other than XmlNodeType.Element was found or if the LocalName and NamespaceURI properties of the element do not match the specified strings.

Исключения

Во входном потоке обнаружен неправильный XML-код.Incorrect XML is encountered in the input stream.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Комментарии

Этот метод пропускает пробелы, комментарии и инструкции по обработке, пока модуль чтения не будет размещен на узле содержимого.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Затем метод проверяет, является ли текущий узел элементом.The method then tests if the current node is an element.

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

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

IsStartElement()

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

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.true if MoveToContent() finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.

Исключения

Во входном потоке обнаружен неправильный XML-код.Incorrect XML is encountered in the input stream.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Примеры

В следующем примере выводится текстовое содержимое каждого элемента.The following example displays the text content of each element.

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 качестве входных данных используется файл.The example uses the file, elems.xml, as input.

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

Комментарии

Этот метод пропускает пробелы, комментарии и инструкции по обработке, пока модуль чтения не будет размещен на узле содержимого.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Затем метод проверяет, является ли текущий узел элементом.The method then tests if the current node is an element.

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

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

IsStartElement(String)

Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствует ли значение свойства Name элемента заданному аргументу.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

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 найденного элемента.The string matched against the Name property of the element found.

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

Boolean

Значение true, если полученный в результате узел является элементом, а свойство Name совпадает с указанной строкой.true if the resulting node is an element and the Name property matches the specified string. Значение false, если обнаружен узел с типом, отличным от XmlNodeType.Element, или если свойство Name элемента не совпадает с указанной строкой.false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.

Исключения

Во входном потоке обнаружен неправильный XML-код.Incorrect XML is encountered in the input stream.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Примеры

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

// 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

Комментарии

Этот метод пропускает пробелы, комментарии и инструкции по обработке, пока модуль чтения не будет размещен на узле содержимого.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Затем метод проверяет, является ли текущий узел элементом.The method then tests if the current node is an element.

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

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