FileSystem.WriteLine(Int32, Object[]) Méthode

Définition

Écrit des données dans un fichier séquentiel. Les données écrites avec Write sont généralement lues à partir d’un fichier à l’aide de Input.

public:
 static void WriteLine(int FileNumber, ... cli::array <System::Object ^> ^ Output);
public static void WriteLine (int FileNumber, params object[] Output);
static member WriteLine : int * obj[] -> unit
Public Sub WriteLine (FileNumber As Integer, ParamArray Output As Object())

Paramètres

FileNumber
Int32

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

Output
Object[]

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

Exemples

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

' Open file for output.
FileOpen(1, "TestFile.txt", OpenMode.Output)
' Print text to the file. The quotation marks will be in the display.
Write(1, "This is a test.")
' Go to the next line.
WriteLine(1)
' Skip a line.
WriteLine(1)
' Print in two print zones. You will see commas and quotation marks
' in the output file.
WriteLine(1, "Zone 1", SPC(10), "Zone 2")
' Build a longer string before calling WriteLine.
WriteLine(1, "Hello" & "  " & "World")
' Include five leading spaces.
WriteLine(1, SPC(5), "Leading spaces")
' Print a word starting at column 10.
WriteLine(1, TAB(10), "Hello")

' Assign Boolean and Date 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.")
' Close the file.
FileClose(1)

' Contents of TestFile.txt
'"This is a test.",
'
'"Zone 1",          "Zone 2"
'"Hello  World"
'     "Leading spaces"
'         ,"Hello"
'"False is a Boolean value."
'"2/12/1969 is a date."

Remarques

Les Write fonctions et WriteLine sont fournies à des fins de compatibilité descendante et peuvent affecter les performances. Pour les applications non héritées, l’objet My.Computer.FileSystem offre de meilleures performances. Pour plus d’informations, consultez Accès aux fichiers avec Visual Basic.

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

Contrairement à la Print fonction, la Write fonction insère des virgules entre les éléments et des guillemets autour des chaînes au fur et à mesure qu’elles sont écrites dans le fichier. Vous n’avez pas besoin de placer des délimiteurs explicites dans la liste. Quand Write est utilisé pour écrire des données dans un fichier, seuls les formats numérique, Boolean, date, null et Error données sont pris en charge. Les hypothèses universelles suivantes sont suivies afin que les données puissent toujours être lues et interprétées correctement à l’aide Inputde , quels que soient les paramètres régionaux :

  • Les données numériques sont toujours écrites en utilisant le point comme séparateur décimal.

  • Pour Boolean les données, ou #FALSE##TRUE# est imprimé. Les True mots clés et False ne sont pas traduits, quels que soient les paramètres régionaux.

  • Les données de date sont écrites dans le fichier à l’aide du format de date universel. Lorsque le composant date ou heure est manquant ou zéro, seule la partie fournie est écrite dans le fichier.

  • Rien n’est écrit dans le fichier si Output les données sont vides. Toutefois, pour les données null, #NULL# est écrit.

  • Pour Error les données, la sortie s’affiche sous la forme #ERROR errorcode#. Le Error mot clé n’est pas traduit, quels que soient les paramètres régionaux.

WriteLine insère un caractère de nouvelle ligne (c’est-à-dire un retour chariot/flux de ligne, ou Chr(13) + Chr(10)), une fois qu’il a écrit le caractère final dans Output le fichier.

Vous pouvez incorporer des guillemets dans une chaîne à l’aide de 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 dans un fichier à l’aide des Write fonctions ou WriteLine nécessite l’accès Append à partir de l’énumération FileIOPermissionAccess . Pour plus d'informations, consultez FileIOPermissionAccess.

S’applique à

Voir aussi