FileSystem.Write(Int32, Object[]) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Booleandanych#TRUE#lub#FALSE#są drukowane. SłowaTruekluczowe iFalsenie 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
Outputdane są puste. Jednak w przypadku danych#NULL#o wartości null są zapisywane.W przypadku
Errordanych dane wyjściowe są wyświetlane jako#ERROR errorcode#. SłowoErrorkluczowe 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ż
- WriteLine(Int32, Object[])
- Input
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- Print(Int32, Object[])
- PrintLine(Int32, Object[])
- Dostęp do plików za pomocą Visual Basic
- Porady: zapisywanie tekstu do plików w Visual Basic
- Instrukcje: zapisywanie tekstu w pliku za pomocą narzędzia Streamwriter (Visual Basic)