Partilhar via


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

Definição

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 TrueFalse é 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