FileSystem.WriteLine(Int32, Object[]) Metoda

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.dll

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

To jest wymagane. Wyrażenie zawierające dowolną prawidłową Integer liczbę plików.

Output
Object[]

Optional. 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ą udostępniane pod kątem 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 File Access with Visual Basic (Dostęp do plików Visual Basic

Jeśli pominięto Output, do pliku zostanie wydrukowany 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, ponieważ są one zapisywane w pliku. Nie musisz umieszczać jawnych ograniczników na liście. W Write przypadku użycia do zapisywania danych w pliku obsługiwane są tylko formaty liczbowe, Booleandaty, wartości null i Error danych. Stosuje się następujące uniwersalne założenia, dzięki czemu dane mogą być zawsze odczytywane i poprawnie 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 wydrukowane są dane #TRUE# lub #FALSE# . 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 brakuje składnika daty lub godziny lub zera, tylko podana część jest zapisywana w pliku.

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

  • 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ż