FileSystem.FileGetObject メソッド

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

FileSystem.FileGetObject メソッド

開かれたディスク ファイルのデータを変数に読み込みます。My 機能を使用すると、FileGetObject を使用した場合よりファイル I/O 操作の生産性とパフォーマンスが向上します。詳細については、「My.Computer.FileSystem オブジェクト」を参照してください。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub FileGetObject
 ( _
    FileNumber As Integer, _
    ByRef Value As Object,
 _
    <OptionalAttribute> Optional RecordNumber As
 Long = -1 _
)

Visual Basic (使用法)

Dim FileNumber As Integer
Dim Value As Object
Dim RecordNumber As Long

FileSystem.FileGetObject(FileNumber, Value, RecordNumber)

C#

public static void FileGetObject
 (
    int FileNumber,
    ref Object Value,
    [OptionalAttribute] long RecordNumber
)

C++

public:
static void FileGetObject (
    int FileNumber, 
    Object^% Value, 
    [OptionalAttribute] long long RecordNumber
)

J#

public static void FileGetObject
 (
    int FileNumber, 
    /** @ref */ Object Value, 
    /** @attribute OptionalAttribute() */ long RecordNumber
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

FileNumber

必須。有効な任意のファイル番号。

Value

必須。データを読み込む有効な変数名。

RecordNumber

省略可能。読み込みを始めるレコード番号 (ランダム モード ファイル) やバイト位置 (バイナリ モード ファイル)。

解説

詳細については、Visual Basic のトピック「FileGetObject 関数」を参照してください。

Integer 型、Long 型、Short 型などではなく、Object 型が返された場合、FileGetObject 関数を FileGet の代わりに使用して、コンパイル時のあいまいさを回避します。

Variant 型を書き出す場合は、FileGetObject が必要です。判断に迷った場合、2 番目のパラメータにオブジェクトを使用しているのであれば、FilePutObject および FileGetObject を使用することをお勧めします。

FileGetObject は、ランダム モードおよびバイナリ モードの場合にだけ有効です。

FileGetObject で読み込まれたデータは、通常、FilePutObject で書き込まれます。

ファイルの中で先頭のレコード番号またはバイト位置は 1 になり、2 番目のレコード番号またはバイト位置は 2 になります。RecordNumber を省略した場合、FileGetObject は、最後に呼び出した FileGetObject 関数または FilePutObject 関数、あるいは最後に呼び出した Seek 関数が示す位置の後のレコードまたはバイトを読み取ります。

使用例

レコードをテスト ファイルに読み込んで取得する例を次に示します。

Visual Basic

Dim c As Object = "test"
FileSystem.FileOpen(1, "test.dat", OpenMode.Binary)
FileSystem.FilePutObject(1, "ABCDEF")
FileSystem.Seek(1, 1)
FileSystem.FileGetObject(1, c)
MsgBox(c)
FileSystem.FileClose(1)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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、1.1、1.0

参照

関連項目
FileSystem クラス
FileSystem メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
FileGetObject 関数
FilePut 関数
FileOpen 関数
Seek 関数
FileGet 関数
Visual Basic でのファイルの読み取り
Visual Basic でのファイルへの書き込み