FileSystem.WriteLine(Int32, Object[]) Metoda

Definicja

Zapisuje dane w pliku sekwencyjnym. Dane zapisywane Write za pomocą polecenia są zwykle odczytywane z pliku przy użyciu polecenia 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())

Parametry

FileNumber
Int32

Wymagane. Wyrażenie Integer zawierające dowolny prawidłowy numer pliku.

Output
Object[]

Opcjonalny. Co najmniej jedno wyrażenie rozdzielane przecinkami do zapisu w pliku.

Przykłady

W tym przykładzie użyto funkcji do zapisywania Write danych pierwotnych w pliku sekwencyjnym.

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

Uwagi

Funkcje Write i WriteLine są zapewniane w celu zapewnienia zgodności z poprzednimi wersjami i mogą mieć wpływ na wydajność. W przypadku aplikacji innych My.Computer.FileSystem niż starsze obiekt zapewnia lepszą wydajność. Aby uzyskać więcej informacji, zobacz Dostęp do plików za pomocą języka Visual Basic.

W przypadku pominięcia Outputdo pliku zostanie wyświetlony pusty wiersz. Wiele wyrażeń można rozdzielić przecinkami.

Print W przeciwieństwie do funkcji funkcja Write wstawia przecinki między elementami i znakami cudzysłowu wokół ciągów podczas ich zapisywania w pliku. Nie trzeba umieszczać jawnych ograniczników na liście. Gdy Write jest używany do zapisywania danych w pliku, obsługiwane są tylko formaty liczbowe, Booleandaty, wartości null i Error danych. Poniżej przedstawiono uniwersalne założenia, dzięki czemu dane mogą być zawsze odczytywane i prawidłowo interpretowane przy użyciu ustawień Inputregionalnych, niezależnie od ustawień regionalnych:

  • Dane liczbowe są zawsze zapisywane przy użyciu kropki jako separatora dziesiętnego.

  • W przypadku Boolean danych #TRUE##FALSE# lub są drukowane. Słowa True kluczowe i False nie są tłumaczone, niezależnie od ustawień regionalnych.

  • Dane daty są zapisywane w pliku przy użyciu uniwersalnego formatu daty. Gdy składnik daty lub godziny jest nieobecny lub równy zero, tylko podana część jest zapisywana do pliku.

  • Nic nie jest zapisywane w pliku, jeśli Output dane są puste. Jednak w przypadku danych #NULL# o wartości null jest zapisywana.

  • W przypadku Error danych dane wyjściowe są wyświetlane jako #ERROR errorcode#. Słowo Error kluczowe nie jest tłumaczone, niezależnie od ustawień regionalnych.

WriteLine Wstawia znak nowego wiersza (czyli znak powrotu karetki/kanału informacyjnego lub Chr(13) + Chr(10)), po zapisaniu końcowego znaku w Output pliku.

Znaki cudzysłowu można osadzić w ciągu przy użyciu podwójnych cudzysłowów lub "". Na przykład

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

Zwraca ciąg z wartością Double quotation marks aren't "difficult" to handle.

Zapisywanie w pliku przy użyciu Write funkcji lub WriteLine wymaga Append dostępu z wyliczenia FileIOPermissionAccess . Aby uzyskać więcej informacji, zobacz FileIOPermissionAccess .

Dotyczy

Zobacz też