FileSystem.FileGet Methode

Definition

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

Überlädt

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

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, String, Int64, Boolean)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, ValueType, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Single, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Int64, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Int32, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Decimal, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Double, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, DateTime, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Char, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Byte, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

FileGet(Int32, Boolean, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Das My-Feature bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystemFor more information, see FileSystem

FileGet(Int32, Int16, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see FileSystem.

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

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Array

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

ArrayIsDynamic
Boolean

Optional.Optional. Betrifft nur das Schreiben eines Arrays.Applies only when writing an array. Gibt an, ob das Array als dynamisches Array behandelt werden soll und ein Arraydeskriptor erforderlich ist, der die Größe und die Begrenzungen des Arrays beschreibt.Specifies whether the array is to be treated as dynamic and whether an array descriptor describing the size and bounds of the array is necessary.

StringIsFixedLength
Boolean

Optional.Optional. Betrifft nur das Schreiben einer Zeichenfolge.Applies only when writing a string. Gibt an, ob ein 2-Byte-Deskriptor für die Zeichenfolge geschrieben werden soll, der die Länge beschreibt.Specifies whether to write a two-byte descriptor for the string that describes the length. Die Standardeinstellung ist False.The default is False.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the starting of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, String, Int64, Boolean)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
String

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

StringIsFixedLength
Boolean

Optional.Optional. Betrifft nur das Schreiben einer Zeichenfolge.Applies only when writing a string. Gibt an, ob ein 2-Byte-Deskriptor für die Zeichenfolge geschrieben werden soll, der die Länge beschreibt.Specifies whether to write a two-byte descriptor for the string that describes the length. Die Standardeinstellung ist False.The default is False.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, ValueType, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
ValueType

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Single, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Single

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Int64, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Int64

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Int32, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Int32

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Decimal, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Decimal

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Double, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Double

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit derFileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using theFileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, DateTime, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
DateTime

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel in eine Datei mit FilePutgeschrieben.Data read with FileGet is usually written to a file with FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liestFileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function,FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Char, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Char

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel in eine Datei mit FilePutgeschrieben.Data read with FileGet is usually written to a file with FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Byte, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Byte

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel in eine Datei mit FilePutgeschrieben.Data read with FileGet is usually written to a file with FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. , Wenn der Deskriptor nicht verwendet wird.If the descriptor is not used. Die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, bestimmen, was gelesen werden soll.Then the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Boolean, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Das My-Feature bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystemFor more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Boolean

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel in eine Datei mit FilePutgeschrieben.Data read with FileGet is usually written to a file with FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit derFileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using theFileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

FileGet(Int32, Int16, Int64)

Liest Daten aus einer offenen Datenträgerdatei in eine Variable.Reads data from an open disk file into a variable. Die My-Funktion bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als FileGet.The My feature gives you better productivity and performance in file I/O operations than FileGet. Weitere Informationen finden Sie unter FileSystem.For more information, see 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)

Parameter

FileNumber
Int32

Erforderlich.Required. Eine beliebige gültige Dateinummer.Any valid file number.

Value
Int16

Erforderlich.Required. Der gültige Name einer Variablen, in die Daten gelesen werden.Valid variable name into which data is read.

RecordNumber
Int64

Dies ist optional.Optional. Datensatznummer (Dateien im Random-Modus) oder Bytenummer (Dateien im Binary-Modus), bei der der Lesevorgang beginnt.Record number (Random mode files) or byte number (Binary mode files) at which reading starts.

Ausnahmen

RecordNumber < 1 und ungleich –1.RecordNumber < 1 and not equal to -1.

Dateimodus ist ungültig.File mode is invalid.

Hinweise

FileGet ist nur im Random-und Binary Modus gültig.FileGet is valid only in Random and Binary mode.

Mit FileGet gelesene Daten werden in der Regel mithilfe FilePutin eine Datei geschrieben.Data read with FileGet is usually written to a file by using FilePut.

Der erste Datensatz oder das Byte in einer Datei befindet sich an Position 1, der zweite Datensatz bzw. das zweite Byte befindet sich an Position 2 usw.The first record or byte in a file is at position 1, the second record or byte is at position 2, and so on. Wenn Sie RecordNumberweglassen, wird der nächste Datensatz oder das nächste Byte, der auf den letzten FileGet oder die FilePut Funktion folgt (bzw. auf die letzte Seek Funktion verwiesen), gelesen.If you omit RecordNumber, the next record or byte following the last FileGet or FilePut function (or pointed to by the last Seek function) is read.

Wichtig

Treffen Sie beim Lesen aus Dateien keine Entscheidungen zum Inhalt einer Datei, die auf der Dateinamenerweiterung basiert.When reading from files, do not make decisions about the contents of a file based on the file name extension. Beispielsweise ist eine Datei mit dem Namen Form1. vb möglicherweise keine Visual Basic Quelldatei.For example, a file that is named Form1.vb may not be a Visual Basic source file.

Zufälliger ModusRandom Mode

Für Dateien, die im Random Modus geöffnet werden, gelten die folgenden Regeln:For files opened in Random mode, the following rules apply:

  • Wenn die Länge der gelesenen Daten kleiner ist als die Länge, die in der RecordLength-Klausel der FileOpen-Funktion angegeben ist, liest FileGet nachfolgende Datensätze über Grenzen der Daten Satz Länge.If the length of the data being read is less than the length specified in the RecordLength clause of the FileOpen function, FileGet reads subsequent records on record-length boundaries. Der Leerraum zwischen dem Ende eines Datensatzes und dem Anfang des nächsten Datensatzes wird mit dem vorhandenen Inhalt des Datei Puffers aufgefüllt.The space between the end of one record and the start of the next record is padded with the existing contents of the file buffer. Da die Menge der Auffüll Daten nicht mit Sicherheit bestimmt werden kann, empfiehlt es sich im Allgemeinen, die Daten Satz Länge mit der Länge der gelesenen Daten zu vergleichen.Because the amount of padding data cannot be determined with any certainty, it is generally a good idea to have the record length match the length of the data being read.

  • Wenn die Variable, die in gelesen wird, eine Zeichenfolge ist, liest FileGet standardmäßig einen zwei-Byte-Deskriptor, der die Zeichen folgen Länge enthält, und liest dann die Daten, die in die Variable fließen.By default, if the variable being read into is a string, FileGet reads a two-byte descriptor that contains the string length and then reads the data that goes into the variable. Daher muss die von der RecordLength-Klausel der FileOpen-Funktion angegebene Daten Satz Länge mindestens zwei Bytes aufweisen, die größer als die tatsächliche Länge der Zeichenfolge ist.Therefore, the record length specified by the RecordLength clause of the FileOpen function must be at least two bytes greater than the actual length of the string. In Visual Basic 6,0 und früheren Versionen werden Zeichen folgen mit fester Länge unterstützt. beim Einfügen in eine Datei wird der Längen Deskriptor nicht geschrieben.Visual Basic 6.0 and earlier versions support fixed-length strings; when put to a file, the length descriptor is not written. Wenn Sie eine Zeichenfolge ohne den Deskriptor lesen möchten, sollten Sie True an den StringIsFixedLength-Parameter übergeben, und die Zeichenfolge, in die Sie eingelesen haben, sollte die richtige Länge aufweisen.If you want to read a string without the descriptor, you should pass True to the StringIsFixedLength parameter, and the string you read into should be the correct length.

  • Wenn die zu lesende Variable ein Array ist, können Sie auswählen, ob ein Deskriptor für die Größe und Dimension des Arrays gelesen werden soll.If the variable being read into is an array, you can choose whether to read a descriptor for the size and dimension of the array. Legen Sie zum Schreiben des Deskriptors den ArrayIsDynamic-Parameter auf Truefest.To write the descriptor, set the ArrayIsDynamic parameter to True. Beim Lesen des Arrays müssen Sie der Art und Weise entsprechen, wie das Array geschrieben wurde.When reading the array, you have to match the way the array was written. Wenn Sie mit dem Deskriptor geschrieben wurde, müssen Sie den Deskriptor lesen.If it was written with the descriptor, you have to read the descriptor. Wenn der Deskriptor nicht verwendet wird, bestimmen die Größe und die Begrenzungen des Arrays, das an FileGet übermittelt wird, was gelesen werden soll.If the descriptor is not used, the size and bounds of the array passed into FileGet determine what to read.

    Der Deskriptor gibt den Rang des Arrays, die Größe und die unteren Grenzen für jeden Rang an.The descriptor specifies the rank of the array, the size, and the lower bounds for each rank. Die Länge ist 2 plus das 8-fache der Anzahl der Dimensionen: (2 + 8 * anzahldimensionen).Its length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die vom RecordLength-Parameter in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Schreiben der Array Daten und des Array Deskriptors erforderlich sind.The record length specified by the RecordLength parameter in the FileOpen function must be greater than or equal to the sum of all the bytes required to write the array data and the array descriptor. Die folgende Array Deklaration benötigt z. b. 218 bytes, wenn das Array auf den Datenträger geschrieben wird.For example, the following array declaration requires 218 bytes when the array is written to disk.

    Dim MyArray(4, 9) As Integer
    

    Die 218 Bytes werden wie folgt verteilt:The 218 bytes are distributed as follows:

    • 18 Bytes für den Deskriptor: (2 + 8 * 2)18 bytes for the descriptor: (2 + 8 * 2)

    • 200 Bytes für die Daten: (5 * 10 * 4).200 bytes for the data: (5 * 10 * 4).

  • Wenn die Variable, die in gelesen wird, ein beliebiger anderer Typ von Variable ist (keine Zeichenfolge mit variabler Länge oder ein Objekt), liest FileGet nur die Variablen Daten.If the variable being read into is any other type of variable (not a variable-length string or an object), FileGet reads only the variable data. Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Länge der gelesenen Daten sein.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the length of the data being read.

  • FileGet liest Elemente von Strukturen so, als ob jede einzeln gelesen würde, mit dem Unterschied, dass es keine Auffüll Zeichen zwischen Elementen gibt.FileGet reads elements of structures as if each were being read individually, except that there is no padding between elements. Auf einem Datenträger wird einem dynamischen Array in einem benutzerdefinierten Typ (geschrieben mit FilePut) ein Deskriptor vorangestellt, dessen Länge 2 plus dem 8-fachen der Anzahl von Dimensionen entspricht: (2 + 8 * anzahldimensionen).On disk, a dynamic array in a user-defined type (written with FilePut) is prefixed by a descriptor whose length equals 2 plus 8 times the number of dimensions: (2 + 8 * NumberOfDimensions). Die von der RecordLength-Klausel in der FileOpen-Funktion angegebene Daten Satz Länge muss größer oder gleich der Summe aller Bytes sein, die zum Lesen der einzelnen Elemente erforderlich sind.The record length specified by the RecordLength clause in the FileOpen function must be greater than or equal to the sum of all the bytes required to read the individual elements. Dies schließt beliebige Arrays und deren Deskriptoren ein.This includes any arrays and their descriptors. Das VBFixedString-Attribut kann auf Zeichen folgen Felder in den Strukturen angewendet werden, um die Größe einer Zeichenfolge anzugeben, wenn Sie auf den Datenträger geschrieben wird.The VBFixedString attribute can be applied to string fields in the structures to indicate the size of a string when written to disk.

BinärmodusBinary Mode

Bei Dateien, die im Binary Modus geöffnet wurden, gelten die meisten Random Modusregeln mit einigen Ausnahmen.For files opened in Binary mode, most of the Random mode rules apply, with some exceptions. Die folgenden Regeln für Dateien, die im Binary Modus geöffnet werden, unterscheiden sich von den Regeln für Random-Modus:The following rules for files opened in Binary mode differ from the rules for Random mode:

  • Die RecordLength-Klausel in der FileOpen-Funktion hat keine Auswirkungen.The RecordLength clause in the FileOpen function has no effect. FileGet liest alle Variablen von einem Datenträger zusammenhängend. Das heißt, ohne Auffüll Zeichen zwischen Datensätzen.FileGet reads all variables from disk contiguously; that is, without padding between records.

  • Bei einem anderen Array als einem Array in einer Struktur liest FileGet nur die Daten.For any array other than an array in a structure, FileGet reads only the data. Es wurde kein Deskriptor gelesen.No descriptor is read.

  • FileGet liest Zeichen folgen variabler Länge, bei denen es sich nicht um Elemente von Strukturen handelt, ohne den zwei Byte langen Längen Deskriptor zu erwarten.FileGet reads variable-length strings that are not elements of structures without expecting the two-byte length descriptor. Die Anzahl der gelesenen Bytes ist mit der Anzahl von Zeichen in der Zeichenfolge.The number of bytes read equals the number of characters already in the string.

    Wichtig

    Zum Lesen aus einer Datei mit der FileGet-Funktion ist Read Zugriff von der FileIOPermissionAccess-Enumeration erforderlich.Reading from a file by using the FileGet function requires Read access from the FileIOPermissionAccess enumeration.

Siehe auch

Gilt für: