XmlReader.ReadElementContentAs Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Legge l'elemento corrente e restituisce il contenuto come oggetto del tipo specificato.

Overload

Nome	Descrizione
ReadElementContentAs(Type, IXmlNamespaceResolver)	Legge il contenuto dell'elemento come tipo richiesto.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quello dell'elemento corrente, quindi legge il contenuto dell'elemento come tipo richiesto.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Origine:

XmlReader.cs

Legge il contenuto dell'elemento come tipo richiesto.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parametri

returnType

Type

Tipo del valore da restituire.

Nota Con il rilascio di .NET Framework 3.5, il valore del returnType parametro può ora essere il DateTimeOffset tipo.

namespaceResolver

IXmlNamespaceResolver

Oggetto IXmlNamespaceResolver utilizzato per risolvere eventuali prefissi dello spazio dei nomi correlati alla conversione dei tipi.

Valori restituiti

Object

Contenuto dell'elemento convertito nell'oggetto tipizzato richiesto.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

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

XmlException

L'elemento corrente contiene elementi figlio.

oppure

Il contenuto dell'elemento non può essere convertito nel tipo richiesto.

ArgumentNullException

Il metodo viene chiamato con null argomenti.

OverflowException

Leggere Decimal.MaxValue.

Esempio

Nell'esempio seguente viene utilizzato il ReadElementContentAs metodo per leggere il contenuto del date nodo.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

L'esempio usa il dataFile.xml file 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 ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Origine:

XmlReader.cs

Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quello dell'elemento corrente, quindi legge il contenuto dell'elemento come tipo richiesto.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parametri

returnType

Type

Tipo del valore da restituire.

Nota Con il rilascio di .NET Framework 3.5, il valore del returnType parametro può ora essere il DateTimeOffset tipo.

namespaceResolver

IXmlNamespaceResolver

Oggetto IXmlNamespaceResolver utilizzato per risolvere eventuali prefissi dello spazio dei nomi correlati alla conversione dei tipi.

localName

String

Nome locale dell'elemento.

namespaceURI

String

URI dello spazio dei nomi dell'elemento.

Valori restituiti

Object

Contenuto dell'elemento convertito nell'oggetto tipizzato richiesto.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

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

XmlException

L'elemento corrente contiene elementi figlio.

oppure

Il contenuto dell'elemento non può essere convertito nel tipo richiesto.

ArgumentNullException

Il metodo viene chiamato con null argomenti.

ArgumentException

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quello dell'elemento corrente letto.

OverflowException

Leggere Decimal.MaxValue.

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 .