XmlReader.ReadElementContentAs メソッド

定義

名前空間:: System.Xml

アセンブリ:: System.Xml.dll, System.Xml.ReaderWriter.dll

アセンブリ:: netstandard.dll, System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の要素を読み取り、指定された型のオブジェクトとして内容を返します。

オーバーロード

名前	説明
ReadElementContentAs(Type, IXmlNamespaceResolver)	要求された型として要素の内容を読み取ります。
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	指定したローカル名と名前空間 URI が現在の要素の URI と一致することを確認し、要求された型として要素の内容を読み取ります。

ReadElementContentAs(Type, IXmlNamespaceResolver)

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

要求された型として要素の内容を読み取ります。

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

パラメーター

returnType: Type

返される値の型。

メモ .NET Framework 3.5 のリリースでは、 returnType パラメーターの値を DateTimeOffset 型にできるようになりました。

namespaceResolver: IXmlNamespaceResolver

型変換に関連するすべての名前空間プレフィックスを解決するために使用される IXmlNamespaceResolver オブジェクト。

返品

Object

要求された型指定されたオブジェクトに変換された要素コンテンツ。

例外

InvalidOperationException

XmlReaderは要素上に配置されません。

-又は-

前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。

XmlException

現在の要素には子要素が含まれています。

-又は-

要素の内容を要求された型に変換することはできません。

ArgumentNullException

このメソッドは、 null 引数を使用して呼び出されます。

OverflowException

Decimal.MaxValueを読み取る。

例

次の例では、 ReadElementContentAs メソッドを使用して、 date ノードの内容を読み取ります。

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

この例では、 dataFile.xml ファイルを入力として使用します。

<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>

注釈

このメソッドは、開始タグ(要素の内容)を読み取り、リーダーを終了要素タグの後に移動します。エンティティが展開され、処理命令とコメントは無視されます。要素には単純なコンテンツのみを含めることができます。つまり、子要素を持つことはできません。

詳細については、 XmlReader リファレンスページの「解説」セクションと W3C XML スキーマパート 2: データ型に関する推奨事項を参照してください。

このメソッドの非同期バージョンについては、 ReadElementContentAsAsyncを参照してください。

適用対象

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

ソース:: XmlReader.cs

指定したローカル名と名前空間 URI が現在の要素の URI と一致することを確認し、要求された型として要素の内容を読み取ります。

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