XmlReader.IsStartElement Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Sprawdza, czy bieżący węzeł zawartości jest tagiem startowym.

Przeciążenia

IsStartElement(String, String)	Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a LocalName właściwości i NamespaceURI elementu znalezionego są zgodne z podanymi ciągami.
IsStartElement()	Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu.
IsStartElement(String)	Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a Name właściwość znalezionego elementu jest zgodna z danym argumentem.

IsStartElement(String, String)

Źródło:

XmlReader.cs

Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a LocalName właściwości i NamespaceURI elementu znalezionego są zgodne z podanymi ciągami.

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

Ciąg zgodny z właściwością LocalName znalezionego elementu.

ns

String

Ciąg zgodny z właściwością NamespaceURI znalezionego elementu.

Zwraca

Boolean

true jeśli wynikowy węzeł jest elementem. false jeśli typ węzła inny niż XmlNodeType.Element został znaleziony lub jeśli LocalName właściwości i NamespaceURI elementu nie są zgodne z określonymi ciągami.

Wyjątki

XmlException

W strumieniu wejściowym napotkano niepoprawny kod XML.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda pomija białe odstępy, komentarze i instrukcje przetwarzania, aż czytnik zostanie umieszczony w węźle zawartości. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.

Zobacz też

• MoveToContent()

IsStartElement()

Źródło:

XmlReader.cs

Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem 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

Zwraca

Boolean

true jeśli MoveToContent() znajdzie tag początkowy lub pusty tag elementu; false jeśli zostanie znaleziony typ węzła inny niż XmlNodeType.Element został znaleziony.

Wyjątki

XmlException

W strumieniu wejściowym napotkano niepoprawny kod XML.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

W poniższym przykładzie jest wyświetlana zawartość tekstowa każdego elementu.

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

W przykładzie użyto pliku , elems.xmljako danych wejściowych.

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

Uwagi

Ta metoda pomija białe odstępy, komentarze i instrukcje przetwarzania, aż czytnik zostanie umieszczony w węźle zawartości. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.

Zobacz też

• MoveToContent()

IsStartElement(String)

Źródło:

XmlReader.cs

Wywołuje MoveToContent() i sprawdza, czy bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a Name właściwość znalezionego elementu jest zgodna z danym argumentem.

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

Ciąg dopasowany do Name właściwości znalezionego elementu.

Zwraca

Boolean

true jeśli wynikowy węzeł jest elementem, a Name właściwość jest zgodna z określonym ciągiem. false jeśli typ węzła inny niż XmlNodeType.Element został znaleziony lub jeśli właściwość elementu Name nie jest zgodna z określonym ciągiem.

Wyjątki

XmlException

W strumieniu wejściowym napotkano niepoprawny kod XML.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

Poniższy przykład przedstawia każdy element ceny.

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

Uwagi

Ta metoda pomija białe odstępy, komentarze i instrukcje przetwarzania, aż czytnik zostanie umieszczony w węźle zawartości. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.

Zobacz też

• MoveToContent()