XmlReader.IsStartElement Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет, является ли текущий узел содержимого открывающим тегом.
IsStartElement(String, String) |
Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствуют ли значения свойств LocalName и NamespaceURI элемента заданным строкам. |
IsStartElement() |
Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента. |
IsStartElement(String) |
Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствует ли значение свойства Name элемента заданному аргументу. |
IsStartElement(String, String)
Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствуют ли значения свойств LocalName и NamespaceURI элемента заданным строкам.
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
найденного элемента.
Возвращаемое значение
Значение 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();
public virtual bool IsStartElement ();
abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool
Public Overridable Function IsStartElement () As 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.
}
}
}
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>
Комментарии
Этот метод пропускает пробелы, комментарии и инструкции по обработке, пока средство чтения не будет размещено на узле содержимого. Затем метод проверяет, является ли текущий узел элементом.
См. также раздел
Применяется к
.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(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
найденного элемента.
Возвращаемое значение
Значение 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());
}
}
' Parse the file and display each price node.
While reader.Read()
If reader.IsStartElement("price") Then
Console.WriteLine(reader.ReadInnerXml())
End If
End While
Комментарии
Этот метод пропускает пробелы, комментарии и инструкции по обработке, пока средство чтения не будет размещено на узле содержимого. Затем метод проверяет, является ли текущий узел элементом.
См. также раздел
Применяется к
.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 |