XmlReader.IsStartElement Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Přetížení

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

IsStartElement(String, String)

Zdroj:

XmlReader.cs

Volá MoveToContent() a testuje, zda je aktuální uzel obsahu počáteční značkou nebo prázdnou značkou elementu a pokud nalezené LocalName vlastnosti NamespaceURI 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 elementu.

ns

String

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

Návraty

Boolean

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

Výjimky

XmlException

Ve vstupním datovém proudu 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 zpráva "Asynchronní operace už probíhá".

Poznámky

Tato metoda přeskočí prázdné znaky, komentáře a pokyny ke zpracování, dokud čtečka nebude umístěna na uzlu obsahu. Metoda pak testuje, zda aktuální uzel je prvek.

Viz také

• MoveToContent()

IsStartElement()

Zdroj:

XmlReader.cs

Volá MoveToContent() a testuje, jestli je aktuální uzel obsahu počáteční značkou 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

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

Výjimky

XmlException

Ve vstupním datovém proudu 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 zpráva "Asynchronní operace už 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

Příklad používá soubor , elems.xmljako vstup.

<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 ke zpracování, dokud čtečka nebude umístěna na uzlu obsahu. Metoda pak testuje, zda aktuální uzel je prvek.

Viz také

• MoveToContent()

IsStartElement(String)

Zdroj:

XmlReader.cs

Volá MoveToContent() a testuje, zda je aktuální uzel obsahu počáteční značkou nebo prázdnou značkou elementu a pokud 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ídá Name vlastnosti nalezeného prvku.

Návraty

Boolean

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

Výjimky

XmlException

Ve vstupním datovém proudu 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 zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad zobrazí každý prvek 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 ke zpracování, dokud čtečka nebude umístěna na uzlu obsahu. Metoda pak testuje, zda aktuální uzel je prvek.

Viz také

• MoveToContent()