XmlReader.IsStartElement Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Testa se o nó de conteúdo atual é uma tag de início.

Sobrecargas

Name Description
IsStartElement(String, String)

Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazio e se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas.
IsStartElement()

Chama MoveToContent() e testa se o nó de conteúdo atual é uma tag de início ou uma tag de elemento vazio.
IsStartElement(String)

Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazia e se a Name propriedade do elemento encontrado corresponde ao argumento dado.

IsStartElement(String, String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazio e se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas.

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

Parâmetros

localname
String

A cadeia a corresponder à LocalName propriedade do elemento encontrada.

ns
String

A cadeia a corresponder à NamespaceURI propriedade do elemento encontrada.

Devoluções

Boolean

true se o nó resultante for um elemento. false se foi encontrado um tipo de nó diferente XmlNodeType.Element de ou se as LocalName propriedades e NamespaceURI do elemento não correspondem às strings especificadas.

Exceções

XmlException

O XML incorreto é encontrado no fluxo de entrada.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

Este método evita espaços em branco, comentários e instruções de processamento até que o leitor esteja posicionado num nó de conteúdo. O método testa então se o nó atual é um elemento.

Ver também

Aplica-se a

IsStartElement()

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Chama MoveToContent() e testa se o nó de conteúdo atual é uma tag de início ou uma tag de elemento vazio.

public:
 virtual bool IsStartElement();
public virtual bool IsStartElement();
abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool
Public Overridable Function IsStartElement () As Boolean

Devoluções

Boolean

true se MoveToContent() encontrar uma etiqueta inicial ou uma etiqueta de elemento vazia; false se foi encontrado um tipo de nó diferente de XmlNodeType.Element outro.

Exceções

XmlException

O XML incorreto é encontrado no fluxo de entrada.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Exemplos

O exemplo seguinte mostra o conteúdo textual de cada elemento.

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

O exemplo usa o ficheiro , elems.xmlcomo entrada.

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

Observações

Este método evita espaços em branco, comentários e instruções de processamento até que o leitor esteja posicionado num nó de conteúdo. O método testa então se o nó atual é um elemento.

Ver também

Aplica-se a

IsStartElement(String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazia e se a Name propriedade do elemento encontrado corresponde ao argumento dado.

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

Parâmetros

name
String

A corda correspondia à Name propriedade do elemento encontrado.

Devoluções

Boolean

true se o nó resultante for um elemento e a Name propriedade corresponder à cadeia especificada. false se foi encontrado um tipo de nó diferente XmlNodeType.Element de ou se a propriedade do elemento Name não corresponder à cadeia especificada.

Exceções

XmlException

O XML incorreto é encontrado no fluxo de entrada.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Exemplos

O exemplo seguinte mostra cada elemento de preço.

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

Observações

Este método evita espaços em branco, comentários e instruções de processamento até que o leitor esteja posicionado num nó de conteúdo. O método testa então se o nó atual é um elemento.

Ver também

Aplica-se a