El objeto File (archivo) proporciona métodos para acceder, leer y escribir información de un archivo o a un archivo en el disco. Al utilizar este objeto, es posible guardar o abrir configuraciones en varias sesiones del programa.
AppendContents
File.AppendContents(filePath, contents)
Abre el archivo indicado y agrega el contenido al final del archivo.
filePath
La ruta completa del archivo a leer. Por ejemplo, c:\temp\settings.data.
contents
El contenido a agregar al final del archivo.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
CopyFile
File.CopyFile(sourceFilePath, destinationFilePath)
Copia el archivo fuente especificado en la ruta de destino. Si la ruta de destino no existe, el método tratará de crearla automáticamente.
Los archivos que ya existen se sobrescribirán. Es una buena práctica comprobar primero si el archivo ya existe para evitar sobrescribir archivos que ya existen.
sourceFilePath
La ruta completa del archivo que hay que copiar. Por ejemplo, c:\temp\settings.data.
destinationFilePath
La ubicación o la ruta al archivo de destino.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
CreateDirectory
File.CreateDirectory(directoryPath)
Crea el directorio indicado.
directoryPath
La ruta completa del directorio a crear.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
DeleteDirectory
File.DeleteDirectory(directoryPath)
Borra el directorio especificado.
directoryPath
La ruta completa del directorio a borrar.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
DeleteFile
File.DeleteFile(filePath)
Borra el archivo indicado.
filePath
La ruta de destino o del archivo. Por ejemplo, c:\temp\settings.data.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
GetFiles
File.GetFiles(directoryPath)
Obtiene la ruta de los archivos en la ruta dada.
directoryPath
El directorio donde buscar los archivos.
Returns
Si la operación se ejecuta con éxito, devuelve el archivo como una matriz. De lo contrario, devuelve "FAILED".
GetSettingsFilePath
File.GetSettingsFilePath()
Obtiene la ruta completa del archivo de configuración de este programa. El nombre del archivo de configuración se basa en el nombre del programa y se encuentra en la misma ruta que el programa.
Returns
La ruta completa del archivo de configuración específico para este programa.
GetTemporaryFilePath
File.GetTemporaryFilePath()
Crea un archivo temporal nuevo en un directorio temporal y devuelve la ruta completa del archivo.
Returns
La ruta completa al archivo temporal.
InsertLine
File.InsertLine(filePath, lineNumber, contents)
Abre el archivo indicado e inserta el contenido en el número de línea indicado.
Esta operación no sobrescribirá ningún contenido existente en la línea indicada.
filePath
La ruta completa del archivo a leer. Por ejemplo, c:\temp\settings.data.
lineNumber
El número de línea de texto a insertar.
contents
El contenido a insertar en el archivo.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
ReadContents
File.ReadContents(filePath)
Abre un archivo y lee todo su contenido. Este método es más rápido para archivos de menos de 1 MB y empezará a ser considerablemente lento para archivos de más de 10 MB.
filePath
La ruta completa del archivo a leer. Por ejemplo, c:\temp\settings.data.
Returns
El contenido completo del archivo.
ReadLine
File.ReadLine(filePath, lineNumber)
Abre el archivo indicado y lee el contenido del número de línea que se indica.
filePath
La ruta completa del archivo a leer. Por ejemplo, c:\temp\settings.data.
lineNumber
El número de línea del texto a leer.
Returns
El texto en la línea indicada del archivo indicado.
WriteContents
File.WriteContents(filePath, contents)
Abre un archivo y escribe el contenido indicado en él, reemplazando el contenido original con el nuevo contenido.
filePath
La ruta completa del archivo a escribir. Por ejemplo, c:\temp\settings.data.
contents
El contenido a escribir en el archivo indicado.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".
WriteLine
File.WriteLine(filePath, lineNumber, contents)
Abre el archivo especificado y escribe el contenido del número de línea que se indica.
Esta operación sobrescribirá cualquier contenido en la línea indicada.
filePath
La ruta completa del archivo a leer. Por ejemplo, c:\temp\settings.data.
lineNumber
El número de línea del texto a escribir.
contents
El contenido a escribir en la línea indicada del archivo indicado.
Returns
Si la operación se completa con éxito, devuelve "SUCCESS". De lo contrario, devuelve "FAILED".