FileSystem.FileGet 方法

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。

重载

FileGet(Int32, Array, Int64, Boolean, Boolean)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, String, Int64, Boolean)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, ValueType, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Single, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Int64, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Int32, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Decimal, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Double, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, DateTime, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Char, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Byte, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Boolean, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。
FileGet(Int32, Int16, Int64)	将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。

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

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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

可选。 仅在写入字符串时适用。 指定是否为描述长度的字符串写入一个双字节说明符。 默认值为 False。

例外

ArgumentException

RecordNumber< 1 且不等于 -1。

IOException

文件模式无效。

注解

FileGet 仅在 Random 和 Binary 模式下有效。

使用 FileGet 读取的数据通常通过使用 FilePut写入文件。

文件中的第一条记录或字节位于位置 1，第二条记录或字节位于位置 2，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 FilePut 函数后 (或最后一个函数) 指向的下 Seek 一个记录或字节。

重要

从文件中读取时，不要根据文件扩展名决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于以 Random 模式打开的文件，以下规则适用：

• 如果要读取的数据的长度小于函数的 FileOpen 子句中指定的RecordLength长度，FileGet则 读取记录长度边界上的后续记录。 使用文件缓冲区的现有内容填充一条记录末尾和下一条记录开始之间的空格。 由于无法确定填充数据的数量，因此通常最好让记录长度与正在读取的数据的长度相匹配。

• 默认情况下，如果要读入的变量是字符串， FileGet 则读取包含字符串长度的双字节描述符，然后读取进入该变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少大于字符串的实际长度的两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;如果放入文件，则不写入长度描述符。 如果要读取不带描述符的字符串，则应传递给 TrueStringIsFixedLength 参数，并且读入的字符串应为正确的长度。

• 如果要读入的变量是一个数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而无需使用双字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从 FileIOPermissionAccess 枚举进行访问。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, String, Int64, Boolean)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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

可选。 仅在写入字符串时适用。 指定是否为描述长度的字符串写入一个双字节说明符。 默认值为 False。

例外

ArgumentException

RecordNumber< 1 且不等于 -1。

IOException

文件模式无效。

注解

FileGet 仅在 Random 和 Binary 模式下有效。

使用 FileGet 读取的数据通常通过使用 FilePut写入文件。

文件中的第一条记录或字节位于位置 1，第二条记录或字节位于位置 2，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 FilePut 函数后 (或最后一个函数) 指向的下 Seek 一个记录或字节。

重要

从文件中读取时，不要根据文件扩展名决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于以 Random 模式打开的文件，以下规则适用：

• 如果要读取的数据的长度小于函数的 FileOpen 子句中指定的RecordLength长度，FileGet则 读取记录长度边界上的后续记录。 使用文件缓冲区的现有内容填充一条记录末尾和下一条记录开头之间的空格。 由于无法确定填充数据的数量，因此通常最好让记录长度与正在读取的数据的长度相匹配。

• 默认情况下，如果要读入的变量是字符串， FileGet 则读取包含字符串长度的双字节描述符，然后读取进入该变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少大于字符串的实际长度的两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;如果放入文件，则不写入长度描述符。 如果要读取不带描述符的字符串，则应传递给 TrueStringIsFixedLength 参数，并且读入的字符串应为正确的长度。

• 如果要读入的变量是一个数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而无需使用双字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从 FileIOPermissionAccess 枚举进行访问。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, ValueType, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 FilePut 函数后 (或最后一个函数) 指向的下 Seek 一个记录或字节。

重要

从文件中读取时，不要根据文件扩展名决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于以 Random 模式打开的文件，以下规则适用：

• 如果要读取的数据的长度小于函数的 FileOpen 子句中指定的RecordLength长度，FileGet则 读取记录长度边界上的后续记录。 使用文件缓冲区的现有内容填充一条记录末尾和下一条记录开头之间的空格。 由于无法确定填充数据的数量，因此通常最好让记录长度与正在读取的数据的长度相匹配。

• 默认情况下，如果要读入的变量是字符串， FileGet 则读取包含字符串长度的双字节描述符，然后读取进入该变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少大于字符串的实际长度的两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;如果放入文件，则不写入长度描述符。 如果要读取不带描述符的字符串，则应传递给 TrueStringIsFixedLength 参数，并且读入的字符串应为正确的长度。

• 如果要读入的变量是一个数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而无需使用双字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从 FileIOPermissionAccess 枚举进行访问。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Single, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 FilePut 函数后 (或最后一个函数) 指向的下 Seek 一个记录或字节。

重要

从文件中读取时，不要根据文件扩展名决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于以 Random 模式打开的文件，以下规则适用：

• 如果要读取的数据的长度小于函数的 FileOpen 子句中指定的RecordLength长度，FileGet则 读取记录长度边界上的后续记录。 使用文件缓冲区的现有内容填充一条记录末尾和下一条记录开头之间的空格。 由于无法确定填充数据的数量，因此通常最好让记录长度与正在读取的数据的长度相匹配。

• 默认情况下，如果要读入的变量是字符串， FileGet 则读取包含字符串长度的双字节描述符，然后读取进入该变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少大于字符串的实际长度的两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;如果放入文件，则不写入长度描述符。 如果要读取不带描述符的字符串，则应传递给 TrueStringIsFixedLength 参数，并且读入的字符串应为正确的长度。

• 如果要读入的变量是一个数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Int64, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Int32, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Decimal, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Double, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, DateTime, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Char, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Byte, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Boolean, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 函数之后的下一个记录或 FilePut 字节 (或最后一 Seek 个函数) 所指向的下一个记录或字节。

重要

从文件读取时，不要根据文件扩展名来决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于在模式下 Random 打开的文件，以下规则适用：

• 如果正在读取的数据长度小于函数 的 FileOpen 子句中指定的RecordLength长度，FileGet则读取记录长度边界上的后续记录。 一条记录的末尾和下一条记录的开头之间的空间用文件缓冲区的现有内容填充。 由于无法确定填充数据量，因此通常最好让记录长度与正在读取的数据的长度匹配。

• 默认情况下，如果正在读取的变量是字符串， FileGet 则读取包含字符串长度的两字节描述符，然后读取进入变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少比字符串的实际长度大两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;放入文件时，不会写入长度描述符。 如果要在没有描述符的情况下读取字符串，则应传递给 TrueStringIsFixedLength 参数，并且读取到的字符串应为正确的长度。

• 如果要读取的变量是数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而不期望两字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用FileGet 函数从文件读取需要 Read 从枚举访问 FileIOPermissionAccess 。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)

FileGet(Int32, Int16, Int64)

Source:

FileSystem.vb

将数据从打开的磁盘文件读入到一个变量中。 相比 FileGet，My 功能可使文件 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，依序排列。 如果省略 RecordNumber，则读取最后 FileGet 一个 或 FilePut 函数后 (或最后一个函数) 指向的下 Seek 一个记录或字节。

重要

从文件中读取时，不要根据文件扩展名决定文件的内容。 例如，名为 Form1.vb 的文件可能不是 Visual Basic 源文件。

随机模式

对于以 Random 模式打开的文件，以下规则适用：

• 如果要读取的数据的长度小于函数的 FileOpen 子句中指定的RecordLength长度，FileGet则 读取记录长度边界上的后续记录。 使用文件缓冲区的现有内容填充一条记录末尾和下一条记录开头之间的空格。 由于无法确定填充数据的数量，因此通常最好让记录长度与正在读取的数据的长度相匹配。

• 默认情况下，如果要读入的变量是字符串， FileGet 则读取包含字符串长度的双字节描述符，然后读取进入该变量的数据。 因此，函数 RecordLength 的 FileOpen 子句指定的记录长度必须至少大于字符串的实际长度的两个字节。 Visual Basic 6.0 及更早版本支持固定长度字符串;如果放入文件，则不写入长度描述符。 如果要读取不带描述符的字符串，则应传递给 TrueStringIsFixedLength 参数，并且读入的字符串应为正确的长度。

• 如果要读入的变量是一个数组，则可以选择是否读取数组的大小和维度的描述符。 若要编写描述符，请将 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 读取不是结构的元素的可变长度字符串，而无需使用双字节长度描述符。 读取的字节数等于字符串中已有的字符数。

  重要

  使用 FileGet 函数从文件读取需要 Read 从 FileIOPermissionAccess 枚举进行访问。

另请参阅

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• 从文件读取 (Visual Basic)
• 写入文件 (Visual Basic)