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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

FileSystem.vb

Grava dados formatados para exibição em um arquivo sequencial.

public:
 static void Print(int FileNumber, ... cli::array <System::Object ^> ^ Output);

public static void Print (int FileNumber, params object[] Output);

static member Print : int * obj[] -> unit

Public Sub Print (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 um feed 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 com 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 convertidas, independentemente da localidade.

Os dados de data são gravados no arquivo usando o formato de data curta padrão reconhecido pelo sistema. Quando o componente de data ou hora está ausente ou zero, apenas a parte fornecida é gravada no arquivo.

Nada será gravado no arquivo se Output os dados estiverem vazios. No entanto, se os dados da Output lista forem DBNull, Null será gravado no arquivo.

Para Error dados, a saída aparece como Error errorcode. O Error palavra-chave não é traduzido 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.

Confira também

• PrintLine(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)