XmlReader.IsStartElement XmlReader.IsStartElement XmlReader.IsStartElement XmlReader.IsStartElement Method

Definizione

Verifica se il nodo di contenuto corrente è un tag di inizio.Tests if the current content node is a start tag.

Overload

IsStartElement(String, String) IsStartElement(String, String) IsStartElement(String, String) IsStartElement(String, String)

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto e se le proprietà LocalName e NamespaceURI dell'elemento trovato corrispondono alle stringhe specificate.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() IsStartElement() IsStartElement() IsStartElement()

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

IsStartElement(String) IsStartElement(String) IsStartElement(String) IsStartElement(String)

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto e se la proprietà Name dell'elemento individuato corrisponde all'argomento specificato.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) IsStartElement(String, String) IsStartElement(String, String) IsStartElement(String, String)

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto e se le proprietà LocalName e NamespaceURI dell'elemento trovato corrispondono alle stringhe specificate.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

Parametri

localname
String String String String

Stringa da confrontare con la proprietà LocalName dell'elemento trovato.The string to match against the LocalName property of the element found.

ns
String String String String

Stringa da confrontare con la proprietà NamespaceURI dell'elemento trovato.The string to match against the NamespaceURI property of the element found.

Restituisce

true, se il nodo risultante è un elemento.true if the resulting node is an element. false se è stato trovato un tipo di nodo diverso da XmlNodeType.Element oppure se le proprietà LocalName e NamespaceURI dell'elemento non corrispondono alle stringhe specificate.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.

Eccezioni

È stata trovata una stringa XML non corretta nel flusso di input.Incorrect XML is encountered in the input stream.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo ignora gli spazi vuoti, i commenti e le istruzioni di elaborazione fino a quando il lettore non è posizionato in corrispondenza di un nodo di contenuto.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Il metodo verifica quindi se il nodo corrente è un elemento.The method then tests if the current node is an element.

Vedi anche

IsStartElement() IsStartElement() IsStartElement() IsStartElement()

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto.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

Restituisce

true se il metodo MoveToContent() trova un tag di inizio oppure un tag di elemento vuoto; false se viene trovato un tipo di nodo diverso da XmlNodeType.Element.true if MoveToContent() finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.

Eccezioni

È stata trovata una stringa XML non corretta nel flusso di input.Incorrect XML is encountered in the input stream.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Esempi

Nell'esempio seguente viene visualizzato il contenuto di testo di ogni elemento.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

Nell'esempio viene usato il file elems.xml,, come input.The example uses the file, elems.xml, as input.

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

Commenti

Questo metodo ignora gli spazi vuoti, i commenti e le istruzioni di elaborazione fino a quando il lettore non è posizionato in corrispondenza di un nodo di contenuto.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Il metodo verifica quindi se il nodo corrente è un elemento.The method then tests if the current node is an element.

Vedi anche

IsStartElement(String) IsStartElement(String) IsStartElement(String) IsStartElement(String)

Chiama il metodo MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio oppure un tag di elemento vuoto e se la proprietà Name dell'elemento individuato corrisponde all'argomento specificato.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

Parametri

name
String String String String

Stringa confrontata con la proprietà Name dell'elemento trovato.The string matched against the Name property of the element found.

Restituisce

true se il nodo risultante è un elemento e la proprietà Name corrisponde alla stringa specificata.true if the resulting node is an element and the Name property matches the specified string. false se è stato trovato un tipo di nodo diverso da XmlNodeType.Element oppure se la proprietà Name dell'elemento non corrisponde alla stringa specificata.false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.

Eccezioni

È stata trovata una stringa XML non corretta nel flusso di input.Incorrect XML is encountered in the input stream.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Esempi

Nell'esempio seguente viene visualizzato ogni elemento price.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

Commenti

Questo metodo ignora gli spazi vuoti, i commenti e le istruzioni di elaborazione fino a quando il lettore non è posizionato in corrispondenza di un nodo di contenuto.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. Il metodo verifica quindi se il nodo corrente è un elemento.The method then tests if the current node is an element.

Vedi anche

Si applica a