XmlReader.IsStartElement XmlReader.IsStartElement XmlReader.IsStartElement XmlReader.IsStartElement Method

定義

現在のコンテンツ ノードが開始タグかどうかをテストします。Tests if the current content node is a start tag.

オーバーロード

IsStartElement(String, String) IsStartElement(String, String) IsStartElement(String, String) 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() IsStartElement() IsStartElement() IsStartElement()

MoveToContent() を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうかをテストします。Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

IsStartElement(String) IsStartElement(String) IsStartElement(String) 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) IsStartElement(String, String) IsStartElement(String, String) 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 String String String

見つかった要素の LocalName プロパティと一致する文字列。The string to match against the LocalName property of the element found.

ns
String String String String

見つかった要素の NamespaceURI プロパティと一致する文字列。The string to match against the NamespaceURI property of the element found.

戻り値

見つかったノードが要素の場合は truetrue if the resulting node is an element. XmlNodeType.Element 以外のノード型が見つかった場合、または要素の LocalName および NamespaceURI プロパティが指定した文字列と一致しない場合は falsefalse 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() IsStartElement() IsStartElement() 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

戻り値

MoveToContent() が開始タグまたは空の要素タグを見つけた場合は trueXmlNodeType.Element 以外のノード型が見つかった場合は falsetrue 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) IsStartElement(String) IsStartElement(String) 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 String String String

見つかった要素の Name プロパティと一致する文字列。The string matched against the Name property of the element found.

戻り値

見つかったノードが要素であり、Name プロパティが指定した文字列と一致する場合は truetrue if the resulting node is an element and the Name property matches the specified string. XmlNodeType.Element 以外のノード型が見つかった場合、または要素の Name プロパティが指定した文字列と一致しない場合は falsefalse 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."

次の例では、各価格要素を表示します。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.

こちらもご覧ください

適用対象