Compartilhar via


FileSystem.WriteLine(Int32, Object[]) Método

Definição

Grava dados em um arquivo sequencial. Dados gravados com Write costumam ser lidos a partir de um arquivo usando 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())

Parâmetros

FileNumber
Int32

Obrigatórios. Uma expressão Integer que contém qualquer número de arquivo válido.

Output
Object[]

Opcional. Uma ou mais expressões delimitadas por vírgula para gravar em um arquivo.

Exemplos

Este exemplo usa a Write função para gravar dados brutos em um arquivo sequencial.

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

Comentários

As Write funções e WriteLine são fornecidas para compatibilidade com versões anteriores e podem afetar o desempenho. Para aplicativos não herdados, o My.Computer.FileSystem objeto fornece melhor desempenho. Para saber mais informações, confira Acesso a Arquivos com o Visual Basic.

Se você omitir Output, uma linha em branco será impressa no arquivo. Várias expressões podem ser separadas com uma vírgula.

Ao contrário da Print função , a Write função insere vírgulas entre itens e aspas ao redor das cadeias de caracteres à medida que elas são gravadas no arquivo. Você não precisa colocar delimitadores explícitos na lista. Quando Write é usado para gravar dados em um arquivo, há suporte apenas para formatos numéricos, Booleande data, nulos e Error de dados. As seguintes suposições universais são seguidas para que os dados sempre possam ser lidos e interpretados corretamente usando Input, independentemente da localidade:

  • Os dados numéricos são sempre gravados usando o período como separador decimal.

  • Para Boolean dados, ou #TRUE##FALSE# é impresso. As True palavras-chave e False não são traduzidas, independentemente da localidade.

  • Os dados de data são gravados no arquivo usando o formato de data universal. Quando o componente de data ou hora está ausente ou zero, somente a parte fornecida é gravada no arquivo.

  • Nada será gravado no arquivo se Output os dados estiverem vazios. No entanto, para dados nulos, #NULL# é gravado.

  • Para Error dados, a saída aparece como #ERROR errorcode#. A Error palavra-chave não é traduzida, independentemente da localidade.

WriteLine insere um caractere de nova linha (ou seja, um retorno de carro/alimentação de linha ou Chr(13) + Chr(10)), depois de ter gravado o caractere final no Output arquivo.

Você pode inserir aspas em uma cadeia de caracteres usando aspas duplas ou "". Por exemplo,

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

retorna uma cadeia de caracteres com o valor de Double quotation marks aren't "difficult" to handle.

Gravar em um arquivo usando as Write funções ou WriteLine requer Append acesso da FileIOPermissionAccess enumeração . Para obter mais informações, consulte FileIOPermissionAccess.

Aplica-se a

Confira também