XmlReader.ReadElementContentAsString Metodo

Definizione

Legge l'elemento corrente e restituisce il contenuto come oggetto String.Reads the current element and returns the contents as a String object.

Overload

ReadElementContentAsString(String, String)

Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge l'elemento e restituisce il contenuto come oggetto String.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

ReadElementContentAsString()

Legge l'elemento corrente e restituisce il contenuto come oggetto String.Reads the current element and returns the contents as a String object.

ReadElementContentAsString(String, String)

Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge l'elemento e restituisce il contenuto come oggetto String.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString (string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Parametri

localName
String

Nome locale dell'elemento.The local name of the element.

namespaceURI
String

URI dello spazio dei nomi dell'elemento.The namespace URI of the element.

Restituisce

Contenuto dell'elemento come oggetto String.The element content as a String object.

Eccezioni

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.The XmlReader is not positioned on an element.

In alternativa-or-

È 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."

L'elemento corrente contiene elementi figlio.The current element contains child elements.

-oppure--or- Il contenuto dell'elemento non può essere convertito in un oggetto String.The element content cannot be converted to a String object.

Il metodo è stato chiamato con argomenti null.The method is called with null arguments.

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quelli dell'elemento corrente da leggere.The specified local name and namespace URI do not match that of the current element being read.

Esempi

Nell'esempio seguente viene letto stringValue l'elemento e viene restituito il contenuto di testo (ignorando il commento e l'istruzione di elaborazione).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

Nell'esempio viene utilizzato il file dataFile.xml come input.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Commenti

Questo metodo legge il tag di inizio, il contenuto dell'elemento e sposta il Reader oltre il tag dell'elemento End.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Espande le entità e ignora le istruzioni di elaborazione e i commenti.It expands entities and ignores processing instructions and comments. L'elemento può contenere solo contenuto semplice.The element can only contain simple content. Ovvero non può avere elementi figlio.That is, it cannot have child elements.

Per ulteriori informazioni, vedere la sezione Osservazioni della pagina XmlReader di riferimento e W3C XML Schema Part 2: Indicazione DataTypes.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

ReadElementContentAsString()

Legge l'elemento corrente e restituisce il contenuto come oggetto String.Reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString ();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

Restituisce

Contenuto dell'elemento come oggetto String.The element content as a String object.

Eccezioni

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.The XmlReader is not positioned on an element.

-oppure--or-

È 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."

L'elemento corrente contiene elementi figlio.The current element contains child elements.

In alternativa-or- Il contenuto dell'elemento non può essere convertito in un oggetto String.The element content cannot be converted to a String object.

Il metodo è stato chiamato con argomenti null.The method is called with null arguments.

Esempi

Nell'esempio seguente viene letto stringValue l'elemento e viene restituito il contenuto di testo (ignorando il commento e l'istruzione di elaborazione).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

Nell'esempio viene utilizzato il file dataFile.xml come input.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Commenti

Questo metodo legge il tag di inizio, il contenuto dell'elemento e sposta il Reader oltre il tag dell'elemento End.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Espande le entità e ignora le istruzioni di elaborazione e i commenti.It expands entities and ignores processing instructions and comments. L'elemento può contenere solo contenuto semplice.The element can only contain simple content. Ovvero non può avere elementi figlio.That is, it cannot have child elements.

Per ulteriori informazioni, vedere la sezione Osservazioni della pagina XmlReader di riferimento e W3C XML Schema Part 2: Indicazione DataTypes.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Per la versione asincrona di questo metodo, vedere ReadElementContentAsStringAsync.For the asynchronous version of this method, see ReadElementContentAsStringAsync.

Si applica a