FileSystem.Write(Int32, Object[]) Methode

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Schreibe Daten in eine sequenzielle Datei. Mit einer Datei geschriebene Write Daten werden in der Regel mithilfe einer InputDatei gelesen.

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

Parameter

FileNumber
Int32

Required. Ein Integer Ausdruck, der eine beliebige gültige Dateinummer enthält.

Output
Object[]

Dies ist optional. Mindestens ein durch Trennzeichen getrennter Ausdruck, der in eine Datei geschrieben werden soll.

Ausnahmen

IOException

Der Dateimodus ist ungültig.

Beispiele

In diesem Beispiel wird die Write Funktion verwendet, um Rohdaten in eine sequenzielle Datei zu schreiben.

' 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."

Hinweise

Die Write Funktionen WriteLine werden aus Gründen der Abwärtskompatibilität bereitgestellt und können sich auf die Leistung auswirken. Bei Nicht-Legacy-Anwendungen bietet das My.Computer.FileSystem Objekt eine bessere Leistung. Weitere Informationen finden Sie unter File Access mit Visual Basic.

Wenn Sie weglassen Output, wird eine leere Zeile in die Datei gedruckt. Mehrere Ausdrücke können durch ein Komma getrennt werden.

Print Im Gegensatz zur Funktion fügt die Write Funktion Kommas zwischen Elementen und Anführungszeichen um Zeichenfolgen ein, während sie in die Datei geschrieben werden. Sie müssen keine expliziten Trennzeichen in die Liste einfügen. Wird Write zum Schreiben von Daten in eine Datei verwendet, werden nur numerische, BooleanDatums-, Null- und Error Datenformate unterstützt. Die folgenden universellen Annahmen werden befolgt, damit die Daten unabhängig vom Gebietsschema immer gelesen und richtig interpretiert Inputwerden können:

  • Numerische Daten werden immer mit dem Punkt als Dezimaltrennzeichen geschrieben.

  • Für Boolean Daten, entweder #TRUE# oder #FALSE# wird gedruckt. Die True Schlüsselwörter und False Schlüsselwörter werden unabhängig vom Gebietsschema nicht übersetzt.

  • Datumsdaten werden mithilfe des universellen Datumsformats in die Datei geschrieben. Wenn entweder das Datum oder die Uhrzeitkomponente fehlt oder null, wird nur der bereitgestellte Teil in die Datei geschrieben.

  • Nichts wird in die Datei geschrieben, wenn Output Daten leer sind. Für NULL-Daten #NULL# wird jedoch geschrieben.

  • Für Error Daten wird die Ausgabe als #ERROR errorcode#. Das Error Schlüsselwort wird unabhängig vom Gebietsschema nicht übersetzt.

WriteLine fügt ein Zeilenumbruchzeichen (d. h. einen Wagenrücklauf/Zeilenvorschub oder Chr(13) + Chr(10)) ein, nachdem es das endgültige Zeichen in Output die Datei geschrieben hat.

Sie können Anführungszeichen in eine Zeichenfolge einbetten, indem Sie doppelte Anführungszeichen oder "" verwenden. Beispiel:

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

gibt eine Zeichenfolge mit dem Wert von Double quotation marks aren't "difficult" to handle.

Für das Schreiben in eine Datei mithilfe der Write Funktionen ist WriteLine der Zugriff über die FileIOPermissionAccess Enumeration erforderlichAppend. Weitere Informationen finden Sie unter FileIOPermissionAccess.

Gilt für:

Weitere Informationen