FileSystem.Write(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 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())

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.

Wyjątki

Tryb pliku jest nieprawidłowy.

Przykłady

W tym przykładzie użyto Write funkcji do zapisywania 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 w celu zapewnienia zgodności z poprzednimi wersjami i mogą mieć wpływ na wydajność. W przypadku aplikacji My.Computer.FileSystem innych niż starsze obiekt zapewnia lepszą wydajność. Aby uzyskać więcej informacji, zobacz Dostęp do plików za pomocą języka 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 Write funkcja wstawia przecinki między elementami i cudzysłowami wokół ciągów, ponieważ są zapisywane w pliku. Nie trzeba 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. Są przestrzegane następujące 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# lub #FALSE# 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 są zapisywane.

  • 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/wiersza karetki 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 or WriteLine wymaga Append dostępu z wyliczenia FileIOPermissionAccess . Aby uzyskać więcej informacji, zobacz FileIOPermissionAccess .

Dotyczy

Zobacz też