XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs Method

定義

現在の要素を読み込み、型指定されたオブジェクトとして内容を返します。Reads the current element and returns the contents as an object of the type specified.

オーバーロード

ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver)

要素の内容を要求された型として返します。Reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、要素の内容を要求された型として読み込みます。Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver)

要素の内容を要求された型として返します。Reads the element content as the requested type.

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

返される値の型。The type of the value to be returned.

.NET Framework 3.5 のリリースでは、returnType パラメーターの値に DateTimeOffset 型を指定できるようになりました。Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

型変換に関連する名前空間プレフィックスの解決に使用される IXmlNamespaceResolver オブジェクト。An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

戻り値

要求された型のオブジェクトに変換された要素の内容。The element content converted to the requested typed object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

または-or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

または-or-

要素のコンテンツを要求された型に変換できません。The element content cannot be converted to the requested type.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

Decimal.MaxValue を読み取りました。Read Decimal.MaxValue.

次の例では、ReadElementContentAsメソッドの内容をdateノード。The following example uses the ReadElementContentAs method to read the content of the date node.

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 ファイルを入力として使用します。The example uses the dataFile.xml file as 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>

注釈

このメソッドは開始タグと、要素の内容を読み取って、終了要素タグを越えてリーダーを移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティを展開し、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つそのことはできません。That is, it cannot have child elements.

詳細については、の「解説」を参照してください、XmlReaderリファレンス ページとW3C XML Schema Part 2。データ型推奨事項。For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

このメソッドの非同期バージョンを参照してください。ReadElementContentAsAsyncします。For the asynchronous version of this method, see ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、要素の内容を要求された型として読み込みます。Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

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

パラメーター

returnType
Type Type Type Type

返される値の型。The type of the value to be returned.

.NET Framework 3.5 のリリースでは、returnType パラメーターの値に DateTimeOffset 型を指定できるようになりました。Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

型変換に関連する名前空間プレフィックスの解決に使用される IXmlNamespaceResolver オブジェクト。An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

localName
String String String String

要素のローカル名。The local name of the element.

namespaceURI
String String String String

要素の名前空間 URI。The namespace URI of the element.

戻り値

要求された型のオブジェクトに変換された要素の内容。The element content converted to the requested typed object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

または-or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

または-or-

要素のコンテンツを要求された型に変換できません。The element content cannot be converted to the requested type.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。The specified local name and namespace URI do not match that of the current element being read.

Decimal.MaxValue を読み取りました。Read Decimal.MaxValue.

注釈

このメソッドは開始タグと、要素の内容を読み取って、終了要素タグを越えてリーダーを移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティを展開し、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つそのことはできません。That is, it cannot have child elements.

詳細については、の「解説」を参照してください、XmlReaderリファレンス ページとW3C XML Schema Part 2。データ型推奨事項。For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

適用対象