FileSystem.FileGetObject, méthode

Article
08/21/2007

Lit les données d'un fichier disque ouvert et les place dans une variable. La fonctionnalité My permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que FileGetObject. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Sub FileGetObject ( _
    FileNumber As Integer, _
    ByRef Value As Object, _
    <OptionalAttribute> Optional RecordNumber As Long = -1 _
)
'Utilisation
Dim FileNumber As Integer
Dim Value As Object
Dim RecordNumber As Long

FileSystem.FileGetObject(FileNumber, Value, RecordNumber)

public static void FileGetObject (
    int FileNumber,
    ref Object Value,
    [OptionalAttribute] long RecordNumber
)

public:
static void FileGetObject (
    int FileNumber, 
    Object^% Value, 
    [OptionalAttribute] long long RecordNumber
)

public static void FileGetObject (
    int FileNumber, 
    /** @ref */ Object Value, 
    /** @attribute OptionalAttribute() */ long RecordNumber
)

JScript ne prend pas en charge le passage d'arguments de type valeur par référence.

Paramètres

FileNumber
Obligatoire. Tout numéro de fichier valide.

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

RecordNumber
Facultatif. Numéro de l'enregistrement (fichiers ouverts en mode Random) ou de l'octet (fichiers ouverts en mode Binary) par lequel la lecture débute.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic FileGetObject, fonction.

La fonction FileGetObject est utilisée à la place de FileGet afin d'éviter les ambiguïtés au moment de la compilation si le type Object est retourné plutôt qu'un autre type, par exemple Integer, Long, Short, etc.

Si vous projetez d'écrire le type Variant, FileGetObject est requis. En cas de doute, si vous utilisez un objet pour le deuxième paramètre, il est conseillé d'utiliser FilePutObject et FileGetObject.

FileGetObject n'est valide qu'en mode Random et Binary.

Les données lues avec FileGetObject sont en général écrites avec FilePutObject.

Le premier enregistrement ou octet d'un fichier occupe la position 1, le deuxième enregistrement ou octet la position 2, et ainsi de suite. Si l'argument RecordNumber est omis, FileGetObject commence la lecture à partir de l'enregistrement ou de l'octet suivant la dernière fonction FileGetObject ou FilePutObject (ou à partir de l'enregistrement ou de l'octet désigné par la dernière fonction Seek).

Exemple

L'exemple suivant lit un enregistrement dans un fichier test, puis le récupère.

Dim c As Object = "test"
FileSystem.FileOpen(1, "test.dat", OpenMode.Binary)
FileSystem.FilePutObject(1, "ABCDEF")
FileSystem.Seek(1, 1)
FileSystem.FileGetObject(1, c)
MsgBox(c)
FileSystem.FileClose(1)

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

FileSystem, classe
Membres FileSystem
Microsoft.VisualBasic, espace de noms

Autres ressources

FileGetObject, fonction
FilePut, fonction
FileOpen, fonction
Seek, fonction
FileGet, fonction
Lecture à partir de fichiers en Visual Basic
Écriture dans des fichiers en Visual Basic

Partager via