XmlReader.IsStartElement Método

Definição

Testa se o nó de conteúdo atual é uma marca inicial.

Sobrecargas

Nome Description
IsStartElement(String, String)

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

IsStartElement()

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

IsStartElement(String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial ou uma marca de elemento vazia e se a Name propriedade do elemento encontrado corresponde ao argumento fornecido.

IsStartElement(String, String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial ou uma marca de elemento vazia e se as LocalName propriedades do NamespaceURI 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 a ser correspondida com a LocalName propriedade do elemento encontrado.

ns
String

A cadeia de caracteres a ser correspondida com a NamespaceURI propriedade do elemento encontrado.

Retornos

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

Exceções

XML incorreto é encontrado no fluxo de entrada.

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada 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

Aplica-se a

IsStartElement()

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial 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

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

Exceções

XML incorreto é encontrado no fluxo de entrada.

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada 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

Aplica-se a

IsStartElement(String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial ou uma marca de elemento vazia e se a Name propriedade do elemento encontrado 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 correspondeu à Name propriedade do elemento encontrado.

Retornos

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

Exceções

XML incorreto é encontrado no fluxo de entrada.

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada 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

Aplica-se a