XmlReader.ReadElementContentAsString Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Legge l'elemento corrente e restituisce il contenuto come oggetto String.

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.
ReadElementContentAsString()	Legge l'elemento corrente e restituisce il contenuto come oggetto String.

ReadElementContentAsString(String, String)

Origine:

XmlReader.cs

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.

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.

namespaceURI

String

URI dello spazio dei nomi dell'elemento.

Restituisce

String

Contenuto dell'elemento come oggetto String.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.

-oppure-

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

XmlException

L'elemento corrente contiene elementi figlio.

-oppure-

Il contenuto dell'elemento non può essere convertito in un oggetto String.

ArgumentNullException

Il metodo è stato chiamato con argomenti null.

ArgumentException

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quelli dell'elemento corrente da leggere.

Esempio

Nell'esempio seguente viene letto l'elemento e viene restituito il contenuto del testo (ignorando l'istruzione stringValue di commento ed elaborazione).

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.

<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 iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Per altre informazioni, vedere la sezione Osservazioni della XmlReader pagina di riferimento e la raccomandazione W3C XML Schema Part 2: Datatypes .

ReadElementContentAsString()

Origine:

XmlReader.cs

Legge l'elemento corrente e restituisce il contenuto come oggetto String.

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

String

Contenuto dell'elemento come oggetto String.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.

-oppure-

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

XmlException

L'elemento corrente contiene elementi figlio.

-oppure-

Il contenuto dell'elemento non può essere convertito in un oggetto String.

ArgumentNullException

Il metodo è stato chiamato con argomenti null.

Esempio

Nell'esempio seguente viene letto l'elemento e viene restituito il contenuto del testo (ignorando l'istruzione stringValue di commento ed elaborazione).

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.

<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 iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Per altre informazioni, vedere la sezione Osservazioni della XmlReader pagina di riferimento e la raccomandazione W3C XML Schema Part 2: Datatypes .

Per la versione asincrona di questo metodo, vedere ReadElementContentAsStringAsync.