XmlReader.IsStartElement Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

Sobrecargas

IsStartElement(String, String)	Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e, se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas.
IsStartElement()	Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazia.
IsStartElement(String)	Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e se a propriedade Name que o elemento encontrou corresponde ao argumento fornecido.

IsStartElement(String, String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e, se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas.

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 de caracteres de correspondência com a propriedade LocalName do elemento encontrado.

ns

String

A cadeia de caracteres de correspondência com a propriedade NamespaceURI do elemento encontrado.

Retornos

Boolean

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

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Esse método ignora o espaço em branco, os comentários e as instruções de processamento até que o leitor seja posicionado em um nó de conteúdo. Em seguida, o método testa se o nó atual é um elemento.

Confira também

• MoveToContent()

IsStartElement()

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

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement ();

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

Public Overridable Function IsStartElement () As Boolean

Retornos

Boolean

true se MoveToContent() encontrar uma marca de início ou uma marca de elemento vazia; false se um tipo de nó diferente de XmlNodeType.Element for encontrado.

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir exibe o conteúdo de texto 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 arquivo, elems.xmlcomo entrada.

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

Comentários

Esse método ignora o espaço em branco, os comentários e as instruções de processamento até que o leitor seja posicionado em um nó de conteúdo. Em seguida, o método testa se o nó atual é um elemento.

Confira também

• MoveToContent()

IsStartElement(String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e se a propriedade Name que o elemento encontrou corresponde ao argumento fornecido.

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 cadeia de caracteres é comparada com a propriedade Name do elemento encontrado.

Retornos

Boolean

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

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir exibe 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

Comentários

Esse método ignora o espaço em branco, os comentários e as instruções de processamento até que o leitor seja posicionado em um nó de conteúdo. Em seguida, o método testa se o nó atual é um elemento.

Confira também

• MoveToContent()