FileSystem.WriteLine(Int32, Object[]) Метод

Определение

Записывает данные в последовательный файл. Данные, записанные с Write помощью 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())

Параметры

FileNumber
Int32

Обязательно. Выражение, содержащее любое допустимое Integer число файла.

Output
Object[]

Optional. Одно или несколько выражений с разделителями-запятыми для записи в файл.

Примеры

В этом примере функция используется Write для записи необработанных данных в последовательный файл.

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

Комментарии

WriteLine Функции Write предоставляются для обратной совместимости и могут повлиять на производительность. Для приложений, отличных от прежних версий, My.Computer.FileSystem объект обеспечивает более высокую производительность. Дополнительные сведения см. в разделе File Access с Visual Basic.

Если не указано Output, пустая строка выводится в файл. Несколько выражений можно разделить запятыми.

Print В отличие от функции, Write функция вставляет запятые между элементами и кавычками вокруг строк, как они записываются в файл. Не нужно помещать явные разделители в список. Если Write используется для записи данных в файл, поддерживаются только числовые, дата, Booleanзначения NULL и Error форматы данных. Следуют следующие универсальные предположения, чтобы данные всегда могли быть прочитаны и правильно интерпретированы с помощью, Inputнезависимо от языкового стандарта:

  • Числовые данные всегда записываются с помощью периода в качестве десятичного разделителя.

  • Для Boolean данных либо #TRUE##FALSE# печатается. False Ключевые True слова не переводятся независимо от языкового стандарта.

  • Данные даты записываются в файл с помощью универсального формата дат. Если отсутствует или ноль даты или компонента времени, в файл записывается только указанная часть.

  • Ничего не записывается в файл, если Output данные пусты. Однако для данных null #NULL# записывается.

  • Для Error данных выходные данные отображаются как #ERROR errorcode#. Ключевое Error слово не преобразуется независимо от языкового стандарта.

WriteLine вставляет новый символ (т. е. возвращаемый или строковый канал каретки или Chr(13) + Chr(10)) после записи окончательного символа в Output файл.

Кавычки можно внедрить в строку с помощью двойных кавычки или "". Например,

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

возвращает строку со значением Double quotation marks aren't "difficult" to handle.

Для записи в файл с помощью Write функций или WriteLine функций требуется Append доступ из FileIOPermissionAccess перечисления. Дополнительные сведения см. в статье FileIOPermissionAccess.

Применяется к

См. также раздел