XmlReader.IsStartElement Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.