XmlReader.IsStartElement Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Testuje, jestli je aktuální uzel obsahu počáteční značkou.

Přetížení

IsStartElement(String, String)	Volá MoveToContent() a testuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli LocalName vlastnosti a NamespaceURI nalezeného elementu odpovídají zadaným řetězcům.
IsStartElement()	Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou Start nebo prázdnou značkou elementu.
IsStartElement(String)	Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli Name vlastnost nalezeného prvku odpovídá danému argumentu.

IsStartElement(String, String)

Zdroj:

XmlReader.cs

Volá MoveToContent() a testuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli LocalName vlastnosti a NamespaceURI nalezeného elementu odpovídají zadaným řetězcům.

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

Parametry

localname

String

Řetězec, který se má shodovat s LocalName vlastností nalezeného prvku.

ns

String

Řetězec, který se má shodovat s NamespaceURI vlastností nalezeného prvku.

Návraty

Boolean

true pokud výsledný uzel je prvek. false pokud byl nalezen jiný typ uzlu než XmlNodeType.Element nebo pokud LocalName vlastnosti a NamespaceURI elementu neodpovídají zadaným řetězcům.

Výjimky

XmlException

Ve vstupním streamu je zjištěn nesprávný kód XML.

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Poznámky

Tato metoda přeskočí prázdné znaky, komentáře a pokyny pro zpracování, dokud čtenář nebude umístěn na uzlu obsahu. Metoda pak otestuje, jestli je aktuální uzel prvek.

Viz také

• MoveToContent()

IsStartElement()

Zdroj:

XmlReader.cs

Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou Start nebo prázdnou značkou elementu.

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement ();

abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool

Public Overridable Function IsStartElement () As Boolean

Návraty

Boolean

truepokud MoveToContent() najde počáteční značku nebo prázdnou značku elementu; false pokud byl nalezen jiný typ uzlu než XmlNodeType.Element

Výjimky

XmlException

Ve vstupním streamu je zjištěn nesprávný kód XML.

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Příklady

Následující příklad zobrazí textový obsah každého prvku.

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

V příkladu se jako vstup používá soubor elems.xml, .

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

Poznámky

Tato metoda přeskočí prázdné znaky, komentáře a pokyny pro zpracování, dokud čtenář nebude umístěn na uzlu obsahu. Metoda pak otestuje, jestli je aktuální uzel prvek.

Viz také

• MoveToContent()

IsStartElement(String)

Zdroj:

XmlReader.cs

Zavolá MoveToContent() a otestuje, jestli je aktuální uzel obsahu značkou start nebo prázdnou značkou elementu a jestli Name vlastnost nalezeného prvku odpovídá danému argumentu.

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

Parametry

name

String

Řetězec odpovídající Name vlastnosti nalezeného elementu.

Návraty

Boolean

true pokud výsledný uzel je prvek a Name vlastnost odpovídá zadanému řetězci. false pokud byl nalezen jiný typ uzlu než XmlNodeType.Element nebo pokud vlastnost elementu Name neodpovídá zadanému řetězci.

Výjimky

XmlException

Ve vstupním streamu je zjištěn nesprávný kód XML.

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Příklady

Následující příklad zobrazuje jednotlivé prvky 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

Poznámky

Tato metoda přeskočí prázdné znaky, komentáře a pokyny pro zpracování, dokud čtenář nebude umístěn na uzlu obsahu. Metoda pak otestuje, jestli je aktuální uzel prvek.

Viz také

• MoveToContent()