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

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

FileSystem.vb

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

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

Примеры

В этом примере функция используется 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."

Комментарии

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

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

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

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

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

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

• Если данные пусты, в файл 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.

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

• Write(Int32, Object[])
• Input
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Print(Int32, Object[])
• PrintLine(Int32, Object[])
• Доступ к файлам с помощью Visual Basic
• Практическое руководство. Запись текста в файлы в Visual Basic
• Практическое руководство. Запись текста в файл с помощью Streamwriter (Visual Basic)