FileSystem.FileGetObject 方法

自開啟的磁碟檔讀取資料至變數中。My 功能提供比 FileGetObject 更強的檔案 I/O 作業產能和效能。如需詳細資訊，請參閱 My.Computer.FileSystem 物件。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Sub FileGetObject ( _
    FileNumber As Integer, _
    ByRef Value As Object, _
    <OptionalAttribute> Optional RecordNumber As Long = -1 _
)
'用途
Dim FileNumber As Integer
Dim Value As Object
Dim RecordNumber As Long

FileSystem.FileGetObject(FileNumber, Value, RecordNumber)

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

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

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

JScript 並不支援以參考方式來傳遞實值型別的引數。

參數

• FileNumber
  必要項。任何有效的檔案號碼。

• Value
  必要項。儲存讀取資料的有效變數名稱。

• RecordNumber
  選擇項。讀取開始的資料錄數目 (Random 模式檔案) 或位元組數目 (Binary 模式檔案)。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 FileGetObject 函式。

FileGetObject 函式會用來取代 FileGet，以避免在傳回型別 Object 而非另一個型別 (如 Integer、Long 或 Short 等) 時，於編譯時期發生的模稜兩可 (Ambiguity) 情況。

如果您打算寫出 Variant 型別，則需要 FileGetObject。當有疑問時，如果您在第二個參數上使用物件，建議您使用 FilePutObject 和 FileGetObject。

FileGetObject 只有在 Random 和 Binary 模式中是有效的。

以 FileGetObject 讀取的資料通常都是使用 FilePutObject 寫入。

檔案中的第一筆記錄或第一個位元組位於位置 1，第二筆記錄或第二個位元組位於位置 2，以此類推。如果省略 RecordNumber，FileGetObject 就會讀取最後一個 FileGetObject 或 FilePutObject 函式之後的資料錄或位元組，或是最後一個 Seek 函式所指向的資料錄或位元組。

範例

下列範例會將資料錄讀入測試檔案，然後擷取它。

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 中寫入檔案