My.Computer.FileSystem.OpenTextFileWriter (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

' Usage
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append)
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append ,encoding)
' Declaration
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean _
) As System.IO.StreamWriter
' -or-
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
) As System.IO.StreamWriter

Parámetros

file
String. Archivo en el que se va a escribir. Obligatorio.
append
Boolean. Especifica si en el archivo la información se anexa o se sobrescribe. Obligatorio.
encoding
Encoding. Codificación que se va a utilizar para escribir en el archivo. El valor predeterminado es UTF8.

Valor devuelto

StreamWriter

Excepciones

La condición siguiente puede hacer que se produzca una excepción:

El nombre de archivo finaliza con una barra oblicua final (ArgumentException).

Comentarios

El método OpenTextFileWriter se abre e inicializa una secuencia para un archivo y, a continuación, devuelve el objeto StreamWriter para esa secuencia. Puede escribir en la secuencia tantas veces como sea necesario y después cerrarla cuando haya finalizado.

Nota:
Debe llamar al método Close en el objeto StreamWriter para asegurarse de que todo los datos se escriben correctamente en la secuencia subyacente.

Si el parámetro append es True, el método anexa el texto al archivo; de lo contrario, se sobrescribe el texto existente en el archivo.

Si escribe solamente algunas cadenas en un archivo, puede resultarle más fácil usar el método WriteAllText. Para obtener más información, vea My.Computer.FileSystem.WriteAllText (Método).

Tareas

En la tabla siguiente se enumera un ejemplo de una tarea en la que interviene el método My.Computer.FileSystem.OpenTextFileWriter.

Para	Vea
Escribir texto en un archivo mediante StreamWriter	Cómo: Escribir texto en archivos con un objeto StreamWriter en Visual Basic

Ejemplo

En este ejemplo se abre un StreamWriter con el método My.Computer.FileSystem.OpenTextFileWriter y se usa para escribir una cadena en un archivo de texto mediante el método WriteLine de la clase StreamWriter.

Dim file As System.IO.StreamWriter
file = My.Computer.FileSystem.OpenTextFileWriter("c:\test.txt", True)
file.WriteLine("Here is the first string.")
file.Close()

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí