XmlReader.ReadElementContentAs Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Legge l'elemento corrente e restituisce il contenuto come oggetto del tipo specificato.
Overload
| ReadElementContentAs(Type, IXmlNamespaceResolver) |
Legge il contenuto dell'elemento come il tipo richiesto. |
| ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) |
Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge il contenuto dell'elemento come il tipo richiesto. |
ReadElementContentAs(Type, IXmlNamespaceResolver)
Legge il contenuto dell'elemento come il 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As ObjectParametri
- returnType
- Type
Tipo di valore da restituire.
Nota Con il rilascio di .NET Framework 3.5, il valore del parametro returnType ora può essere il tipo DateTimeOffset.
- namespaceResolver
- IXmlNamespaceResolver
Oggetto IXmlNamespaceResolver usato per risolvere qualsiasi prefisso di spazio dei nomi correlato al tipo di conversione.
Restituisce
Contenuto dell'elemento convertito nell'oggetto tipizzato richiesto.
Eccezioni
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".
L'elemento corrente contiene elementi figlio.
-oppure-
Il contenuto dell'elemento non può essere convertito nel tipo richiesto.
Il metodo è stato chiamato con argomenti null.
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
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 ReadElementContentAsAsync.
Si applica a
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)
Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge il contenuto dell'elemento come il 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As ObjectParametri
- returnType
- Type
Tipo di valore da restituire.
Nota Con il rilascio di .NET Framework 3.5, il valore del parametro returnType ora può essere il tipo DateTimeOffset.
- namespaceResolver
- IXmlNamespaceResolver
Oggetto IXmlNamespaceResolver usato per risolvere qualsiasi prefisso di spazio dei nomi correlato al tipo di conversione.
- localName
- String
Nome locale dell'elemento.
- namespaceURI
- String
URI dello spazio dei nomi dell'elemento.
Restituisce
Contenuto dell'elemento convertito nell'oggetto tipizzato richiesto.
Eccezioni
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".
L'elemento corrente contiene elementi figlio.
-oppure-
Il contenuto dell'elemento non può essere convertito nel tipo richiesto.
Il metodo è stato chiamato con argomenti null.
Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quelli dell'elemento corrente da leggere.
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 .