Cette documentation est archivée et n’est pas conservée.

FileSystem.WriteLine, méthode

Mise à jour : novembre 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)

public static void WriteLine(
	int FileNumber,
	params Object[] Output
)
public static void WriteLine(
	int FileNumber,
	Object[] Output
)
public static function WriteLine(
	FileNumber : int, 
	... Output : Object[]
)

Paramètres

FileNumber
Type : System.Int32

Obligatoire. Expression Integer qui contient un numéro de fichier valide.

Output
Type : System.Object[]

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

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

Les fonctions Write et WriteLine sont fournies pour des raisons de compatibilité descendante et peuvent affecter 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 Output est omis, une ligne vide est imprimée dans le fichier. Plusieurs expressions peuvent être séparées par 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, date, null 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 imprimé. 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 sur 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 dans 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.

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.


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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: