XmlReader.IsStartElement 方法

定義

命名空間:
System.Xml
組件:
System.Xml.dll, System.Xml.ReaderWriter.dll
組件:
netstandard.dll, System.Xml.ReaderWriter.dll
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll

測試目前的內容節點是否為起始標籤。

多載

名稱 Description
IsStartElement(String, String)

呼叫MoveToContent()並測試目前的內容節點是起始標籤還是空元素標籤，以及所找到元素的 and LocalName 屬性是否NamespaceURI與給定字串相符。
IsStartElement()

呼叫 MoveToContent() 並測試目前的內容節點是起始標籤還是空元素標籤。
IsStartElement(String)

呼叫 MoveToContent() 並測試目前的內容節點是起始標籤還是空元素標籤，以及所找到元素的屬性是否 Name 符合給定參數。

IsStartElement(String, String)

來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs

呼叫MoveToContent()並測試目前的內容節點是起始標籤還是空元素標籤，以及所找到元素的 and 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 會拋出「非同步操作已進行中」的訊息。

備註

此方法跳過留白、註解及處理指令，直到讀取器位於內容節點。 此方法接著測試當前節點是否為元素。

另請參閱

適用於

IsStartElement()

來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
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>

備註

此方法跳過留白、註解及處理指令，直到讀取器位於內容節點。 此方法接著測試當前節點是否為元素。

另請參閱

適用於

IsStartElement(String)

來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
XmlReader.cs
來源:
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 會拋出「非同步操作已進行中」的訊息。

範例

以下範例展示了每個價格元素。

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

備註

此方法跳過留白、註解及處理指令，直到讀取器位於內容節點。 此方法接著測試當前節點是否為元素。

另請參閱

適用於