Compartilhar via


Escrever, funções WriteLine

Grava dados em um arquivo seqüencial.Dados escritos com Write são normalmente lidos a partir de um arquivo com Input.

Public Sub Write( _
   ByVal FileNumber As Integer, _
   ByVal ParamArray Output As Object _
)
' -or-
Public Sub WriteLine( _
   ByVal FileNumber As Integer, _
   ByVal ParamArray Output() As Object _
)

Parâmetros

  • FileNumber
    Obrigatório.An Integer expressão contendo qualquer número de arquivo válido.

  • Output
    Opcional.Um ou mais vírgulas expressões para gravar um arquivo.

Exceções

Tipo de exceção

Número de erro

Condição

IOException

52

FileNumber não existe.

IOException

54

Modo de arquivo é inválido.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

As funções Write e WriteLine são fornecidas para compatibilidade com versões anteriores e podem impactar a performance.Para aplicações novas, o objeto My.Computer.FileSystem fornece melhor performance.Para obter mais informações, consulte Access de Arquivo com o Visual Basic.

Se você omitir Output, uma linha em branco é impressa para o arquivo. Várias expressões podem ser separados por vírgula.

Ao contrário de Print função, o Write função insere vírgulas entre sistema autônomo itens e sistema autônomo aspas ao redor de seqüências de caracteres conforme eles são gravados no arquivo. Não é necessário colocar delimitadores explícitas na lista.Quando Write é usado para gravar dados em um arquivo, numérico somente Boolean, data, nulo, e Error há suporte para formatos de dados. As seguintes suposições universais são seguidas para que os dados sempre podem ser lida e interpretada corretamente usando Input, independentemente da localidade:

  • Dados numéricos são sempre gravados usando o ponto sistema autônomo separador decimal.

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

  • Data de dados é gravada para o arquivo usando o formato de data universal.Quando a data ou o componente de time está ausente ou zero, somente a parte fornecido é gravado no arquivo.

  • Nada será escrito no arquivo se o dado Output estiver vazio.No entanto, para dados nulo, #NULL# foi criado.

  • Para o dado Error, a saída aparecerá como #ERROR errorcode#.The Error palavra-chave não for convertido, independentemente da localidade.

WriteLine Insere um caractere de nova linha (ou seja, um retorno de carro/linha feed, ou Chr(13) + Chr(10)), após ele ter gravado o caractere final Output o arquivo.

Você pode incorporar as aspas em uma seqüência de caracteres usando aspas duplas, ou "".Por exemplo,

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

Retorna uma seqüência de caracteres com o valor de Double quotation marks aren't "difficult" to handle.

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

Exemplo

Este exemplo usa o Write função para gravar dados brutos em um arquivo seqüencial.

FileOpen(1, "TESTFILE", OpenMode.Output) ' Open file for output.
Write(1, "This is a test.")  ' Print text to file.
WriteLine(1)  ' Print blank line to file.
WriteLine(1, "Zone 1", TAB(), "Zone 2")   ' Print in two print zones.
WriteLine(1, "Hello", " ", "World")     ' Separate strings with space.
WriteLine(1, SPC(5), "5 leading spaces ")    ' Print five leading spaces.
WriteLine(1, TAB(10), "Hello")   ' Print word at column 10.

' Assign Boolean, Date, and Error 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")
FileClose(1)   ' Close file.

Anotações Developer Dispositivo Inteligente

Não há suporte para esta função.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**FileSystem

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Tarefas

Como: Gravar texto em arquivos no Visual Basic

Como: Gravar texto em arquivos com um StreamWriter no Visual Basic

Referência

Função Entrada

Função FileOpen

Imprimir, funções PrintLine

Outros recursos

Access de Arquivo com o Visual Basic