FileSystem.FileGet メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.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)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

  関数を使用したファイルからの読み取りには、 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)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, ValueType, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Single, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 に 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Int64, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は および Binary モードでのみRandom有効です。

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

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

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 に 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Int32, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は および Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Decimal, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Double, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, DateTime, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、各ランクの下限を指定します。 その長さは、次元数の 8 倍に 2 を加えた値です (2 + 8 * NumberOfDimensions)。 関数の パラメーターでRecordLengthFileOpen指定されるレコード長は、配列データと配列記述子の書き込みに必要なすべてのバイトの合計以上である必要があります。 たとえば、次の配列宣言では、配列がディスクに書き込まれるときに 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Char, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は および Binary モードでのみRandom有効です。

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

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

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 に 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Byte, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は および Binary モードでのみRandom有効です。

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

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

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 に 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Boolean, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は および Binary モードでのみRandom有効です。

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

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

重要

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

ランダム モード

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

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

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

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

  記述子は、配列のランク、サイズ、および各ランクの下限を指定します。 その長さは、2 に 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 とは異なります。

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み

FileGet(Int32, Int16, Int64)

ソース:

FileSystem.vb

開いたディスク ファイルからデータを読み込んで変数に格納します。 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は と Binary モードでのみRandom有効です。

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

ファイル内の最初のレコードまたはバイトは 1 番目の位置にあり、2 番目のレコードまたはバイトは 2 番目の位置にあります。 を省略RecordNumberすると、最後または関数の後の次のレコードまたはFilePutバイト (または最後FileGetSeekの関数が指す) が読み取られます。

重要

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

ランダム モード

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

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

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

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

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

  Dim MyArray(4, 9) As Integer
  

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

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

  • データの 200 バイト: (5 * 10 * 4)。

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

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

バイナリ モード

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

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

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

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

  重要

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

こちらもご覧ください

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Visual Basic でのファイルの読み取り
• Visual Basic でのファイルへの書き込み