XmlReader.ReadElementContentAsLong

.NET Framework クラス ライブラリ リファレンス

XmlReader.ReadElementContentAsLong メソッド ()

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要素を読み込み、その内容を 64 ビット符号付き整数として返します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAsLong As Long

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As Long

returnValue = instance.ReadElementContentAsLong

C#

public virtual long ReadElementContentAsLong ()

C++

public:
virtual long long ReadElementContentAsLong ()

J#

public long ReadElementContentAsLong ()

JScript

public function ReadElementContentAsLong ()
 : long

戻り値
64 ビット符号付き整数としての要素の内容。

例外

例外の種類	条件
InvalidOperationException	XmlReader が要素に配置されません。
XmlException	現在の要素には、子要素が含まれています。 または 要素の内容を 64 ビット符号付き整数に変換できません。
ArgumentNullException	引数に null 参照 (Visual Basic では Nothing) を渡してメソッドが呼び出されました。

解説

このメソッドは、開始タグと要素の内容を順に読み取り、リーダーを終了要素タグの後に移動します。エンティティを展開し、処理命令およびコメントを無視します。この要素には、単純な内容だけを格納できます。つまり、子要素は格納できません。

内容が型指定された xsd:long の場合、リーダーは、ボックス化が解除された 64 ビット符号付き整数を返します。内容が型指定されていない xsd:long の場合、リーダーは、W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) によって定義された規則に従って 64 ビット符号付き整数に変換しようとします。

詳細については、「型指定されたデータの読み取り」を参照してください。

使用例

ReadElementContentAsLong メソッドを使用して longValue 要素の内容を読み取る例を次に示します。

Visual Basic

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
End Using

C#

using (XmlReader reader = XmlReader.Create("dataFile.xml"))
 {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}

この例では、入力として、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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り

XmlReader.ReadElementContentAsLong メソッド (String, String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み込んで内容を 64 ビット符号付き整数として返します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAsLong ( _
    localName As String, _
    namespaceURI As String _
) As Long

Visual Basic (使用法)

Dim instance As XmlReader
Dim localName As String
Dim namespaceURI As String
Dim returnValue As Long

returnValue = instance.ReadElementContentAsLong(localName, namespaceURI)

C#

public virtual long ReadElementContentAsLong (
    string localName,
    string namespaceURI
)

C++

public:
virtual long long ReadElementContentAsLong (
    String^ localName, 
    String^ namespaceURI
)

J#

public long ReadElementContentAsLong (
    String localName, 
    String namespaceURI
)

JScript

public function ReadElementContentAsLong (
    localName : String, 
    namespaceURI : String
) : long

パラメータ

localName

要素のローカル名。

namespaceURI

要素の名前空間 URI。

戻り値
64 ビット符号付き整数としての要素の内容。

例外

例外の種類	条件
InvalidOperationException	XmlReader が要素に配置されません。
XmlException	現在の要素には、子要素が含まれています。 または 要素の内容を 64 ビット符号付き整数に変換できません。
ArgumentNullException	引数に null 参照 (Visual Basic では Nothing) を渡してメソッドが呼び出されました。
ArgumentException	指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。

解説

このメソッドは、開始タグと要素の内容を順に読み取り、リーダーを終了要素タグの後に移動します。エンティティを展開し、処理命令およびコメントを無視します。この要素には、単純な内容だけを格納できます。つまり、子要素は格納できません。

内容が型指定された xsd:long の場合、リーダーは、ボックス化が解除された 64 ビット符号付き整数を返します。内容が型指定されていない xsd:long の場合、リーダーは、W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) によって定義された規則に従って 64 ビット符号付き整数に変換しようとします。

詳細については、「型指定されたデータの読み取り」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り

XmlReader.ReadElementContentAsLong メソッド

現在の要素を読み込み、その内容を 64 ビット符号付き整数として返します。
オーバーロードの一覧

名前	説明
XmlReader.ReadElementContentAsLong ()	現在の要素を読み込み、その内容を 64 ビット符号付き整数として返します。 .NET Compact Framework によってサポートされています。
XmlReader.ReadElementContentAsLong (String, String)	指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み込んで内容を 64 ビット符号付き整数として返します。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlReader クラス
XmlReader メンバ
System.Xml 名前空間

その他の技術情報

XmlReader による XML の読み取り