FileSystem.PrintLine(Int32, Object[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava dados formatados para exibição em um arquivo sequencial.
public:
static void PrintLine(int FileNumber, ... cli::array <System::Object ^> ^ Output);
public static void PrintLine (int FileNumber, params object[] Output);
static member PrintLine : int * obj[] -> unit
Public Sub PrintLine (FileNumber As Integer, ParamArray Output As Object())
Parâmetros
- FileNumber
- Int32
Obrigatórios. Qualquer número de arquivo válido.
- Output
- Object[]
Opcional. Zero ou mais expressões delimitadas por vírgula a serem gravadas em um arquivo.
As configurações do argumento Output
são:
T:System.IO.IOException
: o modo de arquivo é inválido.
T:System.IO.IOException
: FileNumber
não existe.
Exemplos
Este exemplo usa as Print
funções e PrintLine
para gravar dados em um arquivo.
FileOpen(1, "c:\trash.txt", OpenMode.Output) ' Open file for output.
Print(1, "This is a test.") ' Print text to file.
PrintLine(1) ' Print blank line to file.
PrintLine(1, "Zone 1", TAB(), "Zone 2") ' Print in two print zones.
PrintLine(1, "Hello", "World") ' Separate strings with a tab.
PrintLine(1, SPC(5), "5 leading spaces ") ' Print five leading spaces.
PrintLine(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.
PrintLine(1, aBool, " is a Boolean value")
PrintLine(1, aDate, " is a date")
FileClose(1) ' Close file.
Comentários
As Print
funções e PrintLine
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.
Print
não inclui uma alimentação de linha no final de uma linha; no entanto,PrintLine
inclui um feed de linha.
Dados gravados com Print
costumam ser lidos a partir de um arquivo usando LineInput
ou Input
.
Se você omitir Output
para PrintLine
, uma linha em branco será impressa no arquivo; para Print
, nada será gerado. Várias expressões separadas por uma vírgula serão alinhadas nos limites da guia, mas a combinação de vírgulas e TAB
pode causar resultados inconsistentes.
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 abreviada padrão reconhecido pelo sistema. 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, se Output
os dados da lista forem DBNull
, Null
será gravado no arquivo.
Para Error
dados, a saída aparece como Error errorcode
. A Error
palavra-chave não é traduzida independentemente da localidade.
Todos os dados gravados no arquivo usando Print
são internacionalmente conscientes; ou seja, os dados são formatados corretamente usando o separador decimal apropriado. Se o usuário quiser gerar dados para uso por várias localidades, Write
deverá ser usado.
Gravar em um arquivo usando as Print
funções ou PrintLine
requer Write
acesso da FileIOPermissionAccess
enumeração . Para obter mais informações, consulte FileIOPermissionAccess.
Aplica-se a
Confira também
- Print(Int32, Object[])
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- SPC(Int16)
- TAB
- Write(Int32, Object[])
- WriteLine(Int32, Object[])
- Access de arquivo com o Visual Basic
- Como gravar texto em arquivos no Visual Basic
- Como gravar texto em um arquivo com um Streamwriter (Visual Basic)