FileSystem.Print(Int32, Object[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Writes display-formatted data to a sequential file.
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())
Parameters
- FileNumber
- Int32
Required. Any valid file number.
- Output
- Object[]
Optional. Zero or more comma-delimited expressions to write to a file.
The Output
argument settings are:
T:System.IO.IOException
: File mode is invalid.
T:System.IO.IOException
: FileNumber
does not exist.
Examples
This example uses the Print
and PrintLine
functions to write data to a file.
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.
Remarks
The Print
and PrintLine
functions are provided for backward compatibility and may affect performance. For non-legacy applications, the My.Computer.FileSystem
object provides better performance. For more information, see File Access with Visual Basic.
Print
does not include a line feed at the end of a line; however, PrintLine
does include a line feed.
Data written with Print
is usually read from a file by using LineInput
or Input
.
If you omit Output
for PrintLine
, a blank line is printed to the file; for Print
, nothing is output. Multiple expressions separated with a comma will be aligned on tab boundaries, but mixing commas and TAB
may cause inconsistent results.
For Boolean
data, either True
or False
is printed. The True
and False
keywords are not translated, regardless of the locale.
Date data is written to the file by using the standard short date format recognized by your system. When either the date or the time component is missing or zero, only the part provided is written to the file.
Nothing is written to the file if Output
data is empty. However, if Output
list data is DBNull
, Null
is written to the file.
For Error
data, the output appears as Error errorcode
. The Error
keyword is not translated regardless of the locale.
All data written to the file by using Print
is internationally aware; that is, the data is correctly formatted using the appropriate decimal separator. If the user wishes to output data for use by multiple locales, Write
should be used.
Writing to a file by using the Print
or PrintLine
functions requires Write
access from the FileIOPermissionAccess
enumeration. For more information, see FileIOPermissionAccess .