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

Definición

Escribe datos en un archivo secuencial. Los datos escritos con Write normalmente se leen desde un archivo mediante Input.

public:
 static void Write(int FileNumber, ... cli::array <System::Object ^> ^ Output);
public static void Write (int FileNumber, params object[] Output);
static member Write : int * obj[] -> unit
Public Sub Write (FileNumber As Integer, ParamArray Output As Object())

Parámetros

FileNumber
Int32

Obligatorio. Expresión Integer que contiene cualquier número de archivo válido.

Output
Object[]

Opcional. Una o más expresiones delimitadas por comas para escribir en un archivo.

Excepciones

El modo de archivo no es válido.

Ejemplos

En este ejemplo se usa la Write función para escribir datos sin procesar en un archivo secuencial.

' Open file for output.
FileOpen(1, "TestFile.txt", OpenMode.Output)
' Print text to the file. The quotation marks will be in the display.
Write(1, "This is a test.")
' Go to the next line.
WriteLine(1)
' Skip a line.
WriteLine(1)
' Print in two print zones. You will see commas and quotation marks
' in the output file.
WriteLine(1, "Zone 1", SPC(10), "Zone 2")
' Build a longer string before calling WriteLine.
WriteLine(1, "Hello" & "  " & "World")
' Include five leading spaces.
WriteLine(1, SPC(5), "Leading spaces")
' Print a word starting at column 10.
WriteLine(1, TAB(10), "Hello")

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

' Contents of TestFile.txt
'"This is a test.",
'
'"Zone 1",          "Zone 2"
'"Hello  World"
'     "Leading spaces"
'         ,"Hello"
'"False is a Boolean value."
'"2/12/1969 is a date."

Comentarios

Las Write funciones y WriteLine se proporcionan para la compatibilidad con versiones anteriores y pueden afectar al rendimiento. En el caso de las aplicaciones no heredadas, el My.Computer.FileSystem objeto proporciona un mejor rendimiento. Para más información, consulte Acceso a archivos con Visual Basic.

Si omite Output, se imprime una línea en blanco en el archivo. Se pueden separar varias expresiones con una coma.

A diferencia de la Print función , la Write función inserta comas entre elementos y comillas alrededor de cadenas a medida que se escriben en el archivo. No es necesario colocar delimitadores explícitos en la lista. Cuando Write se usa para escribir datos en un archivo, solo se admiten formatos numéricos, Boolean, date, null y Error de datos. Se siguen las siguientes suposiciones universales para que los datos siempre se puedan leer y interpretar correctamente mediante Input, independientemente de la configuración regional:

  • Los datos numéricos siempre se escriben con el punto como separador decimal.

  • Para Boolean los datos, ya sea #TRUE# o #FALSE# se imprimen. Las True palabras clave y False no se traducen, independientemente de la configuración regional.

  • Los datos de fecha se escriben en el archivo con el formato de fecha universal. Cuando falta la fecha o el componente de hora o cero, solo se escribe la parte proporcionada en el archivo.

  • No se escribe nada en el archivo si Output los datos están vacíos. Sin embargo, para los datos NULL, #NULL# se escribe.

  • Para Error los datos, la salida aparece como #ERROR errorcode#. La Error palabra clave no se traduce, independientemente de la configuración regional.

WriteLine inserta un carácter de nueva línea (es decir, un retorno de carro/avance de línea o Chr(13) + Chr(10)), después de que haya escrito el carácter final en Output en el archivo.

Puede insertar comillas en una cadena mediante comillas dobles o "". Por ejemplo,

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

devuelve una cadena con el valor de Double quotation marks aren't "difficult" to handle.

Escribir en un archivo mediante las Write funciones o WriteLine requiere Append acceso desde la FileIOPermissionAccess enumeración . Para obtener más información, consulta FileIOPermissionAccess.

Se aplica a

Consulte también