XmlReader.ReadElementContentAs Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest das aktuelle Element und gibt den Inhalt als Objekt des angegebenen Typs zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| ReadElementContentAs(Type, IXmlNamespaceResolver) |
Liest den Elementinhalt als angeforderten Typ. |
| ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) |
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, und liest dann den Elementinhalt als angeforderten Typ. |
ReadElementContentAs(Type, IXmlNamespaceResolver)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Liest den Elementinhalt als angeforderten Typ.
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 ObjectParameter
- returnType
- Type
Der Typ des zurückzugebenden Werts.
Hinweis Mit der Version von .NET Framework 3.5 kann der Wert des returnType Parameters nun der DateTimeOffset Typ sein.
- namespaceResolver
- IXmlNamespaceResolver
Ein IXmlNamespaceResolver Objekt, das zum Auflösen aller Namespacepräfixe im Zusammenhang mit der Typkonvertierung verwendet wird.
Gibt zurück
Der In das angeforderte typierte Objekt konvertierte Elementinhalt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in den angeforderten Typ konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Lesen Decimal.MaxValue.
Beispiele
Im folgenden Beispiel wird die ReadElementContentAs Methode verwendet, um den Inhalt des date Knotens zu lesen.
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
Im Beispiel wird die dataFile.xml Datei als Eingabe verwendet.
<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>
Hinweise
Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .
Die asynchrone Version dieser Methode finden Sie unter ReadElementContentAsAsync.
Gilt für:
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, und liest dann den Elementinhalt als angeforderten Typ.
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 ObjectParameter
- returnType
- Type
Der Typ des zurückzugebenden Werts.
Hinweis Mit der Version von .NET Framework 3.5 kann der Wert des returnType Parameters nun der DateTimeOffset Typ sein.
- namespaceResolver
- IXmlNamespaceResolver
Ein IXmlNamespaceResolver Objekt, das zum Auflösen aller Namespacepräfixe im Zusammenhang mit der Typkonvertierung verwendet wird.
- localName
- String
Der lokale Name des Elements.
- namespaceURI
- String
Der Namespace-URI des Elements.
Gibt zurück
Der In das angeforderte typierte Objekt konvertierte Elementinhalt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in den angeforderten Typ konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Der angegebene lokale Name und namespace-URI stimmen nicht mit dem des aktuellen Elements überein, das gelesen wird.
Lesen Decimal.MaxValue.
Hinweise
Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .
