XmlReader.IsStartElement 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

测试当前内容节点是否是开始标记。

重载

IsStartElement(String, String)	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记，以及所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。
IsStartElement()	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记。
IsStartElement(String)	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记，以及所找到元素的 Name 属性是否与给定的参数匹配。

IsStartElement(String, String)

Source:

XmlReader.cs

调用 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 属性匹配的字符串。

返回

Boolean

如果生成的节点是一个元素，则为 true。 如果找到 false 之外的节点类型，或者元素的 XmlNodeType.Element 和 LocalName 属性与指定的字符串不匹配，则为 NamespaceURI。

例外

XmlException

在输入流中遇到不正确的 XML。

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

此方法跳过空白、注释和处理指令，直到读者位于内容节点上。 然后， 方法测试当前节点是否为元素。

另请参阅

• MoveToContent()

IsStartElement()

Source:

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

如果 MoveToContent() 找到开始标记或空元素标记，则为 true；如果找到不同于 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)

Source:

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()