XmlReader.ReadElementContentAs Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Läser det aktuella elementet och returnerar innehållet som ett objekt av den angivna typen.
Överlagringar
| Name | Description |
|---|---|
| ReadElementContentAs(Type, IXmlNamespaceResolver) |
Läser elementinnehållet som den begärda typen. |
| ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) |
Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets och läser sedan elementinnehållet som den begärda typen. |
ReadElementContentAs(Type, IXmlNamespaceResolver)
Läser elementinnehållet som den begärda typen.
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 ObjectParametrar
- returnType
- Type
Typ av värde som ska returneras.
Note Med versionen av .NET Framework 3.5 kan värdet för parametern returnType nu vara DateTimeOffset typ.
- namespaceResolver
- IXmlNamespaceResolver
Ett IXmlNamespaceResolver objekt som används för att matcha namnområdesprefix relaterade till typkonvertering.
Returer
Elementinnehållet konverterades till det begärda typerade objektet.
Undantag
XmlReader Är inte placerad på ett element.
-eller-
En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Det aktuella elementet innehåller underordnade element.
-eller-
Elementinnehållet kan inte konverteras till den begärda typen.
Metoden anropas med null argument.
Läs Decimal.MaxValue.
Exempel
I följande exempel används ReadElementContentAs metoden för att läsa nodens date innehåll.
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
I exemplet används dataFile.xml filen som indata.
<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>
Kommentarer
Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.
Mer information finns i avsnittet Kommentarer på XmlReader referenssidan och W3C XML-schemadel 2: Rekommendationen Datatyper .
Den asynkrona versionen av den här metoden finns i ReadElementContentAsAsync.
Gäller för
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)
Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets och läser sedan elementinnehållet som den begärda typen.
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 ObjectParametrar
- returnType
- Type
Typ av värde som ska returneras.
Note Med versionen av .NET Framework 3.5 kan värdet för parametern returnType nu vara DateTimeOffset typ.
- namespaceResolver
- IXmlNamespaceResolver
Ett IXmlNamespaceResolver objekt som används för att matcha namnområdesprefix relaterade till typkonvertering.
- localName
- String
Elementets lokala namn.
- namespaceURI
- String
Elementets namnområdes-URI.
Returer
Elementinnehållet konverterades till det begärda typerade objektet.
Undantag
XmlReader Är inte placerad på ett element.
-eller-
En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Det aktuella elementet innehåller underordnade element.
-eller-
Elementinnehållet kan inte konverteras till den begärda typen.
Metoden anropas med null argument.
Det angivna lokala namnet och namnområdes-URI:n matchar inte det aktuella element som läses.
Läs Decimal.MaxValue.
Kommentarer
Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.
Mer information finns i avsnittet Kommentarer på XmlReader referenssidan och W3C XML-schemadel 2: Rekommendationen Datatyper .