XmlReader.IsStartElement Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Verifica se il nodo di contenuto corrente è un tag di inizio.

Overload

IsStartElement(String, String)	Chiama MoveToContent() e verifica se il nodo di contenuto è un tag di inizio o un tag di elemento vuoto e se le proprietà LocalName e NamespaceURI dell'elemento trovato corrispondono alle stringhe specificate.
IsStartElement()	Chiama MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio o un tag di elemento vuoto.
IsStartElement(String)	Chiama MoveToContent() e verifica se il nodo corrente è un tag di inizio o un tag di elemento vuoto e se la proprietà Name dell'elemento trovato corrisponde all'argomento specificato.

IsStartElement(String, String)

Chiama MoveToContent() e verifica se il nodo di contenuto è un tag di inizio o un tag di elemento vuoto e se le proprietà LocalName e NamespaceURI dell'elemento trovato corrispondono alle stringhe specificate.

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

Stringa da confrontare con la proprietà LocalName dell'elemento trovato.

ns

String

Stringa da confrontare con la proprietà NamespaceURI dell'elemento trovato.

Restituisce

Boolean

true, se il nodo risultante è un elemento. 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.

Eccezioni

XmlException

È stata trovata una stringa XML non corretta nel flusso di input.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Questo metodo ignora spazi vuoti, commenti ed istruzioni di elaborazione fino a quando il lettore non viene posizionato in un nodo del contenuto. Il metodo verifica quindi se il nodo corrente è un elemento.

Vedi anche

• MoveToContent()

IsStartElement()

Chiama MoveToContent() e verifica se il nodo di contenuto corrente è un tag di inizio o un tag di elemento vuoto.

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

Boolean

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.

Eccezioni

XmlException

È stata trovata una stringa XML non corretta nel flusso di input.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

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

Nell'esempio viene usato il file, , elems.xmlcome input.

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

Commenti

Questo metodo ignora spazi vuoti, commenti ed istruzioni di elaborazione fino a quando il lettore non viene posizionato in un nodo del contenuto. Il metodo verifica quindi se il nodo corrente è un elemento.

Vedi anche

• MoveToContent()

IsStartElement(String)

Chiama MoveToContent() e verifica se il nodo corrente è un tag di inizio o un tag di elemento vuoto e se la proprietà Name dell'elemento trovato corrisponde all'argomento specificato.

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

Stringa confrontata con la proprietà Name dell'elemento trovato.

Restituisce

Boolean

true se il nodo risultante è un elemento e la proprietà Name corrisponde alla stringa specificata. false se è stato trovato un tipo di nodo diverso da XmlNodeType.Element oppure se la proprietà Name dell'elemento non corrisponde alla stringa specificata.

Eccezioni

XmlException

È stata trovata una stringa XML non corretta nel flusso di input.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio seguente viene visualizzato ogni elemento price.

// 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 spazi vuoti, commenti ed istruzioni di elaborazione fino a quando il lettore non viene posizionato in un nodo del contenuto. Il metodo verifica quindi se il nodo corrente è un elemento.

Vedi anche

• MoveToContent()