FileSystem.Write, méthode

Article
08/21/2007

Écrit des données sur un fichier à accès séquentiel. Les données écrites à l'aide de la fonction Write sont généralement lues dans un fichier avec la fonction Input.

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

Syntaxe

'Déclaration
Public Shared Sub Write ( _
    FileNumber As Integer, _
    ParamArray Output As Object() _
)
'Utilisation
Dim FileNumber As Integer
Dim Output As Object()

FileSystem.Write(FileNumber, Output)

public static void Write (
    int FileNumber,
    params Object[] Output
)

public:
static void Write (
    int FileNumber, 
    ... array<Object^>^ Output
)

public static void Write (
    int FileNumber, 
    Object[] Output
)

public static function Write (
    FileNumber : int, 
    ... Output : Object[]
)

Paramètres

FileNumber
Obligatoire. Une expression Integer qui contient un numéro de fichier valide.

Output
Facultatif. Une ou plusieurs expressions délimitées par des virgules à écrire sur un fichier.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Fonctions Write, WriteLine.

Les fonctions Write et WriteLine sont fournies pour des raisons de compatibilité descendante et peuvent avoir un impact sur les performances. Pour les applications non héritées (non-legacy), l'objet My.Computer.FileSystem offre de meilleures performances. Pour plus d'informations, consultez Accès au fichier avec Visual Basic.

Si vous omettez Output, une ligne vierge est imprimée sur le fichier. Plusieurs expressions peuvent être séparées avec une virgule.

Contrairement à la fonction Print, la fonction Write insère des virgules entre les éléments et des guillemets autour des chaînes au moment de leur écriture sur le fichier. Vous n'avez pas besoin de placer de délimiteurs explicites dans la liste. Lorsque Write est utilisé pour écrire des données dans un fichier, seuls les formats de données numériques, Boolean, de date, nuls et Error sont pris en charge. Les hypothèses universelles suivantes sont respectées afin que les données puissent toujours être lues et correctement interprétées à l'aide de Input, indépendamment des paramètres régionaux :

Les données numériques sont toujours écrites en utilisant le point comme séparateur décimal.
Pour les données Boolean, soit #TRUE#, soit #FALSE# est écrit. Les mots clés True et False ne sont pas traduits, indépendamment des paramètres régionaux.
Les données de date sont écrites dans le fichier à l'aide du format de date universel. Lorsque le composant de date ou d'heure manque ou est nul, seule la partie fournie est écrite dans le fichier.
Rien n'est écrit sur le fichier si les données Output sont vides. Toutefois, #NULL# est écrit pour les données nulles.
Pour les données Error, la sortie apparaît sous la forme #ERROR errorcode#. Le mot clé Error n'est pas traduit, indépendamment des paramètres régionaux.

WriteLine insère un caractère de saut de ligne (c'est-à-dire un retour chariot/saut de ligne, ou Chr(13) + Chr(10)), après avoir écrit le dernier caractère dans Output sur le fichier.

Vous pouvez incorporer des guillemets à une chaîne en utilisant des guillemets doubles, ou "". Par exemple,

Dim x As String = "Double quotation marks aren't ""difficult"" to handle."

retourne une chaîne avec la valeur Double quotation marks aren't "difficult" to handle.

L'écriture sur fichier à l'aide de la fonction Write ou WriteLine requiert l'accès Append à partir de l'énumération FileIOPermissionAccess. Pour plus d'informations, consultez FileIOPermissionAccess, énumération.

Exemple

Cet exemple utilise la fonction Write pour écrire des données brutes dans un fichier à accès séquentiel.

FileOpen(1, "TESTFILE", OpenMode.Output) ' Open file for output.
Write(1, "This is a test.")  ' Print text to file.
WriteLine(1)  ' Print blank line to file.
WriteLine(1, "Zone 1", TAB(), "Zone 2")   ' Print in two print zones.
WriteLine(1, "Hello", " ", "World")     ' Separate strings with space.
WriteLine(1, SPC(5), "5 leading spaces ")    ' Print five leading spaces.
WriteLine(1, TAB(10), "Hello")   ' Print word at column 10.

' Assign Boolean, Date, and Error values.
Dim aBool As Boolean
Dim aDate As DateTime
aBool = False
aDate = DateTime.Parse("February 12, 1969")

' Dates and Booleans are translated using locale settings of 
' your system.
WriteLine(1, aBool, " is a Boolean value")
WriteLine(1, aDate, " is a date")
FileClose(1)   ' Close file.

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

Fonctions Write, WriteLine
Input, fonction
FileOpen, fonction
Fonctions Print, PrintLine
Accès au fichier avec Visual Basic
Comment : insérer du texte dans des fichiers dans Visual Basic
Comment : écrire du texte dans des fichiers à l'aide de Streamwriter dans Visual Basic

Partager via