XmlReader.IsStartElement Metoda

Definicja

Testuje, czy bieżący węzeł zawartości jest tagiem początkowym.Tests if the current content node is a start tag.

Przeciążenia

IsStartElement(String, String)

Wywołuje MoveToContent() i testy, jeśli bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu i jeśli właściwości LocalName i NamespaceURI elementu są zgodne z podanym ciągiem.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()

Wywołuje MoveToContent() i testy, jeśli bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

IsStartElement(String)

Wywołuje MoveToContent() i testy, jeśli bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a jeśli właściwość Name elementu znaleziona jest zgodna z podanym argumentem.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)

Wywołuje MoveToContent() i testy, jeśli bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu i jeśli właściwości LocalName i NamespaceURI elementu są zgodne z podanym ciągiem.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

Parametry

localname
String

Ciąg do dopasowania względem właściwości LocalName elementu.The string to match against the LocalName property of the element found.

ns
String

Ciąg do dopasowania względem właściwości NamespaceURI elementu.The string to match against the NamespaceURI property of the element found.

Zwraca

true, jeśli węzeł, który jest elementem.true if the resulting node is an element. false, jeśli typ węzła inny niż XmlNodeType.Element został znaleziony lub jeśli właściwości LocalName i NamespaceURI elementu nie pasują do określonych ciągów.false 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.

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML is encountered in the input stream.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Ta metoda pomija odstępy, komentarze i instrukcje przetwarzania do momentu, gdy czytnik zostanie umieszczony w węźle zawartości.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.The method then tests if the current node is an element.

Zobacz też

IsStartElement()

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

Zwraca

true, jeśli MoveToContent() odnajdzie tag początkowy lub pusty tag elementu; false, jeśli znaleziono typ węzła inny niż XmlNodeType.Element.true if MoveToContent() finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML is encountered in the input stream.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Przykłady

Poniższy przykład wyświetla zawartość tekstową każdego elementu.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

W przykładzie jest użyty plik elems.xmljako dane wejściowe.The example uses the file, elems.xml, as input.

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

Uwagi

Ta metoda pomija odstępy, komentarze i instrukcje przetwarzania do momentu, gdy czytnik zostanie umieszczony w węźle zawartości.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.The method then tests if the current node is an element.

Zobacz też

IsStartElement(String)

Wywołuje MoveToContent() i testy, jeśli bieżący węzeł zawartości jest tagiem początkowym lub pustym tagiem elementu, a jeśli właściwość Name elementu znaleziona jest zgodna z podanym argumentem.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

Parametry

name
String

Ciąg dopasowany do właściwości Name znalezionego elementu.The string matched against the Name property of the element found.

Zwraca

true, jeśli węzeł, który jest elementem, a właściwość Name pasuje do określonego ciągu.true if the resulting node is an element and the Name property matches the specified string. false, jeśli typ węzła inny niż XmlNodeType.Element został znaleziony lub jeśli właściwość Name elementu nie pasuje do określonego ciągu.false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML is encountered in the input stream.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Przykłady

Poniższy przykład wyświetla każdy element ceny.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

Uwagi

Ta metoda pomija odstępy, komentarze i instrukcje przetwarzania do momentu, gdy czytnik zostanie umieszczony w węźle zawartości.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Następnie metoda sprawdza, czy bieżący węzeł jest elementem.The method then tests if the current node is an element.

Zobacz też

Dotyczy