FileSystem.FileGet Méthode

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit les données d’un fichier disque ouvert dans une variable. La My fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que FileGet. Pour plus d’informations, consultez FileSystem.

Surcharges

Nom	Description
FileGet(Int32, Array, Int64, Boolean, Boolean)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, String, Int64, Boolean)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, ValueType, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Single, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Int64, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Int32, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Decimal, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Double, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, DateTime, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Char, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Byte, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Boolean, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.
FileGet(Int32, Int16, Int64)	Lit les données d’un fichier disque ouvert dans une variable. La `My` fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que `FileGet`. Pour plus d’informations, consultez FileSystem.

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

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Array

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

ArrayIsDynamic: Boolean

Optional. S’applique uniquement lors de l’écriture d’un tableau. Spécifie si le tableau doit être traité comme dynamique et si un descripteur de tableau décrivant la taille et les limites du tableau sont nécessaires.

StringIsFixedLength: Boolean

Optional. S’applique uniquement lors de l’écriture d’une chaîne. Spécifie s’il faut écrire un descripteur à deux octets pour la chaîne qui décrit la longueur. La valeur par défaut est False.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Dans un fichier, le premier enregistrement ou octet se trouve à la position 1, le deuxième enregistrement ou octet se trouve à la position 2, etc. Si vous ne spécifiez qu'un enregistrement, seul ce dernier est verrouillé ou déverrouillé. Si vous omettezRecordNumber, l’enregistrement ou l’octet suivant la dernière FilePutFileGet ou fonction (ou pointé par la dernière Seek fonction) est lu.

Important

Lors de la lecture à partir de fichiers, ne prenez pas de décisions sur le contenu d’un fichier en fonction de l’extension de nom de fichier. Par exemple, un fichier nommé Form1.vb peut ne pas être un fichier source Visual Basic.

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

Pour les fichiers ouverts en Binary mode, la plupart des règles de Random mode s’appliquent, avec certaines exceptions. Les règles suivantes pour les fichiers ouverts en Binary mode diffèrent des règles de Random mode :

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, String, Int64, Boolean)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: String

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

StringIsFixedLength: Boolean

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, ValueType, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: ValueType

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Single, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Single

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Int64, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Int64

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Int32, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Int32

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Decimal, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Decimal

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Double, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Double

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de laFileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, DateTime, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: DateTime

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier avec FilePut.

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction,FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Char, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Char

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier avec FilePut.

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Byte, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Byte

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier avec FilePut.

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé. Ensuite, la taille et les limites du tableau passées pour FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Boolean, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Boolean

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier avec FilePut.

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de laFileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

FileGet(Int32, Int16, Int64)

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)

Paramètres

FileNumber: Int32

Required. N’importe quel numéro de fichier valide.

Value: Int16

Required. Nom de variable valide dans lequel les données sont lues.

RecordNumber: Int64

Optional. Numéro d’enregistrement (Random fichiers en mode) ou nombre d’octets (Binary fichiers en mode) au démarrage de la lecture.

Exceptions

ArgumentException

RecordNumber < 1 et non égal à -1.

IOException

Le mode fichier n’est pas valide.

Remarques

FileGetest valide uniquement en mode et Binary en Random mode.

Les données lues avec FileGet sont généralement écrites dans un fichier à l’aide FilePutde .

Important

Mode aléatoire

Pour les fichiers ouverts en Random mode, les règles suivantes s’appliquent :

Si la longueur des données lues est inférieure à la longueur spécifiée dans la RecordLength clause de la FileOpen fonction, FileGet lit les enregistrements suivants sur les limites de longueur d’enregistrement. L’espace entre la fin d’un enregistrement et le début de l’enregistrement suivant est rempli avec le contenu existant de la mémoire tampon de fichier. Étant donné que la quantité de données de remplissage ne peut pas être déterminée avec certitude, il est généralement judicieux d’avoir la longueur de l’enregistrement correspondant à la longueur des données lues.
Par défaut, si la variable en cours de lecture est une chaîne, FileGet lit un descripteur à deux octets qui contient la longueur de la chaîne, puis lit les données qui entrent dans la variable. Par conséquent, la longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être au moins deux octets supérieurs à la longueur réelle de la chaîne. Visual Basic 6.0 et versions antérieures prennent en charge les chaînes de longueur fixe ; lorsqu’elles sont placées dans un fichier, le descripteur de longueur n’est pas écrit. Si vous souhaitez lire une chaîne sans descripteur, vous devez passer True au StringIsFixedLength paramètre et la chaîne dans laquelle vous lisez doit être la longueur correcte.
Si la variable en cours de lecture est un tableau, vous pouvez choisir de lire un descripteur pour la taille et la dimension du tableau. Pour écrire le descripteur, définissez le ArrayIsDynamic paramètre sur True. Lors de la lecture du tableau, vous devez correspondre à la façon dont le tableau a été écrit. S’il a été écrit avec le descripteur, vous devez lire le descripteur. Si le descripteur n’est pas utilisé, la taille et les limites du tableau passées à FileGet déterminer ce qu’il faut lire.

Le descripteur spécifie le rang du tableau, la taille et les limites inférieures pour chaque rang. Sa longueur est égale à 2 plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par le RecordLength paramètre de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour écrire les données du tableau et le descripteur de tableau. Par exemple, la déclaration de tableau suivante nécessite 218 octets lorsque le tableau est écrit sur disque.
```
Dim MyArray(4, 9) As Integer
```
Les 218 octets sont distribués comme suit :
- 18 octets pour le descripteur : (2 + 8 * 2)
- 200 octets pour les données : (5 * 10 * 4).
Si la variable en cours de lecture est un autre type de variable (pas une chaîne de longueur variable ou un objet), FileGet lit uniquement les données de variable. La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la longueur des données lues.
FileGet lit des éléments de structures comme s’ils étaient lus individuellement, sauf qu’il n’y a pas de remplissage entre les éléments. Sur le disque, un tableau dynamique dans un type défini par l’utilisateur (écrit avec FilePut) est précédé d’un descripteur dont la longueur est égale à 2 fois plus 8 fois le nombre de dimensions : (2 + 8 * NumberOfDimensions). La longueur d’enregistrement spécifiée par la RecordLength clause de la FileOpen fonction doit être supérieure ou égale à la somme de tous les octets requis pour lire les éléments individuels. Cela inclut tous les tableaux et leurs descripteurs. L’attribut VBFixedString peut être appliqué aux champs de chaîne dans les structures pour indiquer la taille d’une chaîne lorsqu’elle est écrite sur le disque.

Mode binaire

La RecordLength clause de la fonction n’a FileOpen aucun effet. FileGet lit toutes les variables du disque contiguëment ; autrement dit, sans remplissage entre les enregistrements.
Pour tout tableau autre qu’un tableau d’une structure, FileGet lit uniquement les données. Elle ne lit aucun descripteur.
FileGet lit des chaînes de longueur variable qui ne sont pas des éléments de structures sans attendre le descripteur de longueur à deux octets. Le nombre d’octets lus est égal au nombre de caractères de la chaîne.

Important

La lecture à partir d’un fichier à l’aide de la FileGet fonction nécessite Read un accès à partir de l’énumération FileIOPermissionAccess .

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?