Прочитать на английском

Поделиться через


XmlReader.IsStartElement Метод

Определение

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

Перегрузки

IsStartElement(String, String)

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

IsStartElement()

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

IsStartElement(String)

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

IsStartElement(String, String)

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

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

Параметры

localname
String

Строка, которая противопоставляется значению свойства LocalName найденного элемента.

ns
String

Строка, которая противопоставляется значению свойства NamespaceURI найденного элемента.

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

Boolean

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

Исключения

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

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

Комментарии

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

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

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

.NET 7 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

IsStartElement()

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

public virtual bool IsStartElement ();

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

Boolean

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

Исключения

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

Метод 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.
    }
  }
}

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

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

Комментарии

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

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

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

.NET 7 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

IsStartElement(String)

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

public virtual bool IsStartElement (string name);

Параметры

name
String

Строка противопоставляется значению свойства Name найденного элемента.

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

Boolean

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

Исключения

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

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

Примеры

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

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

Комментарии

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

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

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

.NET 7 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0