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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Escreve dados num ficheiro sequencial. Os dados gravados geralmente Write são lidos 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

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

Output
Object[]

Optional. Uma ou mais expressões delimitadas por vírgulas a serem gravadas 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 as WriteLine funções 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 obter mais informações, consulte File Access com 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 em torno de cadeias de caracteres à medida que 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, Booleandata, nulo e Error 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# impressos. As True palavras-chave e False as palavras-chave 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/feed de linha ou Chr(13) + Chr(10)), depois de ter escrito 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