FileSystem.FileGet メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.dll

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

オーバーロード

名前	説明
FileGet(Int32, Array, Int64, Boolean, Boolean)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, String, Int64, Boolean)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, ValueType, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Single, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Int64, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Int32, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Decimal, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Double, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, DateTime, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Char, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Byte, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Boolean, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。
FileGet(Int32, Int16, Int64)	開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

FileGet(Int32, Array, Int64, Boolean, Boolean)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref Array Value, long RecordNumber = -1, bool ArrayIsDynamic = false, bool StringIsFixedLength = false);

static member FileGet : int * Array * int64 * bool * bool -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Array, Optional RecordNumber As Long = -1, Optional ArrayIsDynamic As Boolean = false, Optional StringIsFixedLength As Boolean = false)

パラメーター

FileNumber

Int32

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

Value

Array

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

ArrayIsDynamic

Boolean

オプション。 配列を書き込む場合にのみ適用されます。 配列を動的として扱うかどうか、および配列のサイズと境界を記述する配列記述子が必要かどうかを指定します。

StringIsFixedLength

Boolean

オプション。 文字列を書き込む場合にのみ適用されます。 長さを記述する文字列の 2 バイト記述子を書き込むかどうかを指定します。 既定値は False です。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの終わりと次のレコードの開始の間のスペースは、ファイル バッファーの既存の内容で埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, String, Int64, Boolean)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref string Value, long RecordNumber = -1, bool StringIsFixedLength = false);

static member FileGet : int * string * int64 * bool -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As String, Optional RecordNumber As Long = -1, Optional StringIsFixedLength As Boolean = false)

パラメーター

FileNumber

Int32

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

Value

String

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

StringIsFixedLength

Boolean

オプション。 文字列を書き込む場合にのみ適用されます。 長さを記述する文字列の 2 バイト記述子を書き込むかどうかを指定します。 既定値は False です。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, ValueType, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref ValueType Value, long RecordNumber = -1);

static member FileGet : int * ValueType * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As ValueType, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

ValueType

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Single, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref float Value, long RecordNumber = -1);

static member FileGet : int * single * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Single, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Single

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Int64, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref long Value, long RecordNumber = -1);

static member FileGet : int * int64 * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Long, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Int64

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Int32, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref int Value, long RecordNumber = -1);

static member FileGet : int * int * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Integer, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Int32

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Decimal, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref decimal Value, long RecordNumber = -1);

static member FileGet : int * decimal * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Decimal, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Decimal

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Double, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref double Value, long RecordNumber = -1);

static member FileGet : int * double * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Double, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Double

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet 関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からのReadアクセスが必要です。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, DateTime, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref DateTime Value, long RecordNumber = -1);

static member FileGet : int * DateTime * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As DateTime, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

DateTime

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより短い場合は、レコード長境界で後続のレコードを読み取FileGet。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Char, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref char Value, long RecordNumber = -1);

static member FileGet : int * char * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Char, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Char

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Byte, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref byte Value, long RecordNumber = -1);

static member FileGet : int * byte * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Byte, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Byte

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合。 次に、 FileGet に渡される配列のサイズと境界によって、読み取る対象が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Boolean, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref bool Value, long RecordNumber = -1);

static member FileGet : int * bool * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Boolean, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Boolean

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet 関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からのReadアクセスが必要です。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic

FileGet(Int32, Int16, Int64)

開いているディスク ファイルから変数にデータを読み取ります。 My機能を使用すると、FileGetよりもファイル I/O 操作の生産性とパフォーマンスが向上します。 詳細については、FileSystemを参照してください。

public static void FileGet(int FileNumber, ref short Value, long RecordNumber = -1);

static member FileGet : int * int16 * int64 -> unit

Public Sub FileGet (FileNumber As Integer, ByRef Value As Short, Optional RecordNumber As Long = -1)

パラメーター

FileNumber

Int32

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

Value

Int16

必須。 データの読み込み先となる有効な変数名です。

RecordNumber

Int64

オプション。 読み取りを開始するレコード番号 (Random モード ファイル) またはバイト番号 (Binary モード ファイル)。

例外

ArgumentException

RecordNumber < 1 で-1 と等しくない。

IOException

ファイル モードが無効です。

注釈

FileGet は、 Random モードと Binary モードでのみ有効です。

FileGetで読み取られたデータは、通常、FilePutを使用してファイルに書き込まれます。

ファイルの最初のレコードまたはバイトは位置 1 になり、2 番目のレコードまたはバイトは位置 2 になります。これ以降も同様です。 RecordNumberを省略すると、最後のFileGetまたはFilePut関数の後の次のレコードまたはバイト (または最後のSeek関数が指す) が読み取られます。

Important

ファイルから読み取る場合は、ファイル名拡張子に基づいてファイルの内容を決定しないでください。 たとえば、Form1.vbという名前のファイルは、Visual Basicソース ファイルではない可能性があります。

ランダム モード

Random モードで開かれたファイルには、次の規則が適用されます。

• 読み取るデータの長さが、FileOpen関数のRecordLength句で指定された長さより小さい場合、FileGetはレコード長境界で後続のレコードを読み取ります。 1 つのレコードの末尾と次のレコードの先頭の間のスペースには、ファイル バッファーの既存の内容が埋め込まれます。 埋め込みデータの量は確実に決定できないため、通常、レコード長が読み取られるデータの長さと一致するようにすることをお勧めします。

• 既定では、読み込まれる変数が文字列の場合、 FileGet は文字列の長さを含む 2 バイトの記述子を読み取り、変数に入るデータを読み取ります。 したがって、FileOpen関数のRecordLength句で指定されるレコード長は、文字列の実際の長さよりも少なくとも 2 バイト大きい必要があります。 Visual Basic 6.0 以前のバージョンでは、固定長文字列がサポートされています。ファイルに配置すると、長さ記述子は書き込まれません。 記述子を使用せずに文字列を読み取る場合は、 True を StringIsFixedLength パラメーターに渡し、読み取る文字列は正しい長さにする必要があります。

• 読み込む変数が配列の場合は、配列のサイズと次元の記述子を読み取るかどうかを選択できます。 記述子を記述するには、 ArrayIsDynamic パラメーターを True に設定します。 配列を読み取るときは、配列の書き込み方法と一致する必要があります。 記述子を使用して書き込まれた場合は、記述子を読み取る必要があります。 記述子が使用されていない場合、 FileGet に渡される配列のサイズと境界によって、読み取る内容が決まります。

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 + 8 次元数の 8 倍に等しくなります (2 + 8 * NumberOfDimensions)。 FileOpen関数の RecordLength パラメーターで指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 218 バイトが必要です。

  Dim MyArray(4, 9) As Integer
  

  218 バイトは次のように分散されます。

  • 記述子の 18 バイト: (2 + 8 * 2)

  • データに対して 200 バイト: (5 * 10 * 4)。

• 読み込まれる変数が他の型の変数 (可変長文字列やオブジェクトではない) である場合、 FileGet は変数データのみを読み取ります。 FileOpen関数のRecordLength句で指定されるレコード長は、読み取られるデータの長さ以上である必要があります。

• FileGet は、要素間に埋め込みがない点を除き、それぞれが個別に読み取られているかのように構造体の要素を読み取ります。 ディスクでは、ユーザー定義型の動的配列 ( FilePut で書き込まれます) には、長さが 2 + 8 倍の次元数 (2 + 8 * NumberOfDimensions) の記述子がプレフィックスとして付けられます。 FileOpen関数のRecordLength句で指定されるレコード長は、個々の要素を読み取るために必要なすべてのバイトの合計以上である必要があります。 これには、配列とその記述子が含まれます。 VBFixedString属性を構造体の文字列フィールドに適用して、ディスクに書き込むときに文字列のサイズを示すことができます。

バイナリ モード

Binary モードで開かれたファイルの場合、Random モードの規則のほとんどは適用され、一部の例外があります。 Binary モードで開かれたファイルに関する次の規則は、Random モードの規則とは異なります。

• FileOpen関数のRecordLength句は無効です。 FileGet ディスクからすべての変数を連続して読み取ります。つまり、レコード間に埋め込む必要はありません。

• 構造体内の配列以外の配列の場合、 FileGet はデータのみを読み取ります。 記述子は読み取られません。

• FileGet は、2 バイト長記述子を予期せずに、構造体の要素ではない可変長文字列を読み取ります。 読み取られるバイト数は、文字列に既に含まれている文字の数と等しいものです。

  Important

  FileGet関数を使用してファイルから読み取るには、FileIOPermissionAccess列挙体からReadアクセスする必要があります。

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic
• Visual Basic