StreamWriter Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase StreamWriter.
Sobrecargas
StreamWriter(Stream) |
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación UTF-8 y el tamaño de búfer predeterminado. |
StreamWriter(String) |
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados. |
StreamWriter(Stream, Encoding) |
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación especificada y el tamaño de búfer predeterminado. |
StreamWriter(String, Boolean) |
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo. |
StreamWriter(String, FileStreamOptions) |
Inicializa una nueva instancia de la clase para el archivo especificado, utilizando la codificación predeterminada, y StreamWriter configurada con el objeto FileStreamOptions especificado. |
StreamWriter(Stream, Encoding, Int32) |
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y el tamaño de búfer especificados. |
StreamWriter(String, Boolean, Encoding) |
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación especificada y tamaño de búfer predeterminado. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo. |
StreamWriter(String, Encoding, FileStreamOptions) |
Inicializa una nueva instancia de la clase para el archivo especificado, utilizando la codificación especificada y configurada StreamWriter con el objeto FileStreamOptions especificado. |
StreamWriter(Stream, Encoding, Int32, Boolean) |
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y tamaño de búfer especificados y, opcionalmente deja abierta la secuencia. |
StreamWriter(String, Boolean, Encoding, Int32) |
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada, con la codificación y el tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo. |
StreamWriter(Stream)
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación UTF-8 y el tamaño de búfer predeterminado.
public:
StreamWriter(System::IO::Stream ^ stream);
public StreamWriter (System.IO.Stream stream);
new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter
Public Sub New (stream As Stream)
Parámetros
- stream
- Stream
Secuencia en la que se va a escribir.
Excepciones
No se puede escribir en stream
.
stream
es null
.
Ejemplos
En el ejemplo de código siguiente se muestra este constructor.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Comentarios
Este constructor crea un con codificación UTF-8 sin Byte-Order Mark (BOM), por lo que su método StreamWriter GetPreamble devuelve una matriz de bytes vacía. La codificación UTF-8 predeterminada para este constructor produce una excepción en bytes no válidos. Este comportamiento es diferente del comportamiento proporcionado por el objeto de codificación en la Encoding.UTF8 propiedad . Para especificar si se produce una excepción en bytes no válidos, use un constructor que acepte un objeto de codificación como parámetro, como StreamWriter . La BaseStream propiedad se inicializa mediante el parámetro stream
. No se restablece la posición de la secuencia.
El StreamWriter objeto llama al objeto proporcionado cuando se llama a Dispose() Stream StreamWriter.Dispose .
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(String)
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados.
public:
StreamWriter(System::String ^ path);
public StreamWriter (string path);
new System.IO.StreamWriter : string -> System.IO.StreamWriter
Public Sub New (path As String)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir. path
puede ser un nombre de archivo.
Excepciones
Acceso denegado.
path
es una cadena vacía ("").
o bien
path
contiene el nombre de un dispositivo del sistema (com1, com2, etc.).
path
es null
.
La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
path
incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.
El llamador no dispone del permiso requerido.
Ejemplos
En el ejemplo de código siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName)
writer.Write(textToAdd)
End Using
End Sub
End Module
Comentarios
Este constructor crea un con codificación UTF-8 sin Byte-Order Mark (BOM), por lo que su método StreamWriter GetPreamble devuelve una matriz de bytes vacía. La codificación UTF-8 predeterminada para este constructor produce una excepción en bytes no válidos. Este comportamiento es diferente del comportamiento proporcionado por el objeto de codificación en la Encoding.UTF8 propiedad . Para especificar una BOM y determinar si se produce una excepción en bytes no válidos, use un constructor que acepte un objeto de codificación como parámetro, como StreamWriter(String, Boolean, Encoding) .
El path
parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de convención de nomenclatura universal (UNC). Si el archivo existe, se sobrescribe; De lo contrario, se crea un nuevo archivo.
No es necesario que el parámetro sea un archivo almacenado en disco; puede ser cualquier parte de un sistema que admita el acceso mediante path
secuencias.
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(Stream, Encoding)
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación especificada y el tamaño de búfer predeterminado.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding)
Parámetros
- stream
- Stream
Secuencia en la que se va a escribir.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
Excepciones
stream
o encoding
es null
.
No se puede escribir en stream
.
Ejemplos
En el ejemplo siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.Default))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Comentarios
Este constructor inicializa la propiedad Encoding mediante el parámetro de codificación y la propiedad mediante el parámetro BaseStream stream. No se restablece la posición de la secuencia. Para obtener información adicional, vea Encoding.
El StreamWriter objeto llama al objeto proporcionado cuando se llama a Dispose() Stream StreamWriter.Dispose .
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- Encoding
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(String, Boolean)
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.
public:
StreamWriter(System::String ^ path, bool append);
public StreamWriter (string path, bool append);
new System.IO.StreamWriter : string * bool -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir.
- append
- Boolean
Es true
para anexar datos al archivo; es false
para sobrescribir el archivo. Si el archivo especificado no existe, este parámetro no tiene ningún efecto y el constructor crea un nuevo archivo.
Excepciones
Acceso denegado.
path
está vacía.
o bien
path
contiene el nombre de un dispositivo del sistema (com1, com2, etc.).
path
es null
.
La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).
path
incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
El llamador no dispone del permiso requerido.
Ejemplos
En el ejemplo de código siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True)
writer.Write(textToAdd)
End Using
End Sub
End Module
Comentarios
Este constructor crea un con codificación UTF-8 sin Byte-Order Mark (BOM), por lo que su método StreamWriter GetPreamble devuelve una matriz de bytes vacía. La codificación UTF-8 predeterminada para este constructor produce una excepción en bytes no válidos. Este comportamiento es diferente del comportamiento proporcionado por el objeto de codificación en la Encoding.UTF8 propiedad . Para especificar una BOM y determinar si se produce una excepción en bytes no válidos, use un constructor que acepte un objeto de codificación como parámetro, como StreamWriter(String, Boolean, Encoding) .
El path
parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de convención de nomenclatura universal (UNC).
No es necesario que el parámetro sea un archivo almacenado en disco; puede ser cualquier parte de un sistema que admita el acceso mediante path
secuencias.
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(String, FileStreamOptions)
Inicializa una nueva instancia de la clase para el archivo especificado, utilizando la codificación predeterminada, y StreamWriter configurada con el objeto FileStreamOptions especificado.
public:
StreamWriter(System::String ^ path, System::IO::FileStreamOptions ^ options);
public StreamWriter (string path, System.IO.FileStreamOptions options);
new System.IO.StreamWriter : string * System.IO.FileStreamOptions -> System.IO.StreamWriter
Public Sub New (path As String, options As FileStreamOptions)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir.
- options
- FileStreamOptions
Objeto que especifica las opciones de configuración para el FileStream subyacente.
Excepciones
options
es null
.
No se puede escribir en stream
.
Consulte también
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(Stream, Encoding, Int32)
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y el tamaño de búfer especificados.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)
Parámetros
- stream
- Stream
Secuencia en la que se va a escribir.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
- bufferSize
- Int32
Tamaño del búfer en bytes.
Excepciones
stream
o encoding
es null
.
bufferSize
es negativo.
No se puede escribir en stream
.
Ejemplos
En el ejemplo siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Comentarios
Este constructor inicializa la Encoding propiedad mediante el parámetro y la propiedad mediante el parámetro encoding
BaseStream stream
. No se restablece la posición de la secuencia. Para obtener información adicional, vea Encoding.
El StreamWriter objeto llama al objeto proporcionado cuando se llama a Dispose() Stream StreamWriter.Dispose .
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- Encoding
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(String, Boolean, Encoding)
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación especificada y tamaño de búfer predeterminado. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);
public StreamWriter (string path, bool append, System.Text.Encoding encoding);
new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean, encoding As Encoding)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir.
- append
- Boolean
Es true
para anexar datos al archivo; es false
para sobrescribir el archivo. Si el archivo especificado no existe, este parámetro no tiene ningún efecto y el constructor crea un nuevo archivo.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
Excepciones
Acceso denegado.
path
está vacía.
o bien
path
contiene el nombre de un dispositivo del sistema (com1, com2, etc.).
path
es null
.
La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).
path
incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
El llamador no dispone del permiso requerido.
Ejemplos
En el ejemplo siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8)
writer.Write(textToAdd)
End Using
End Sub
End Module
Comentarios
Este constructor inicializa la propiedad Encoding mediante el parámetro de codificación . Para obtener información adicional, vea Encoding.
path
puede ser un nombre de archivo, incluido un archivo en un recurso compartido de convención de nomenclatura universal (UNC).
path
no es necesario que sea un archivo almacenado en disco; puede ser cualquier parte de un sistema que admita el acceso a través de secuencias.
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- Encoding
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(String, Encoding, FileStreamOptions)
Inicializa una nueva instancia de la clase para el archivo especificado, utilizando la codificación especificada y configurada StreamWriter con el objeto FileStreamOptions especificado.
public:
StreamWriter(System::String ^ path, System::Text::Encoding ^ encoding, System::IO::FileStreamOptions ^ options);
public StreamWriter (string path, System.Text.Encoding encoding, System.IO.FileStreamOptions options);
new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriter
Public Sub New (path As String, encoding As Encoding, options As FileStreamOptions)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
- options
- FileStreamOptions
Objeto que especifica las opciones de configuración para el FileStream subyacente.
Excepciones
options
es null
.
No se puede escribir en stream
.
Consulte también
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo
Se aplica a
StreamWriter(Stream, Encoding, Int32, Boolean)
Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y tamaño de búfer especificados y, opcionalmente deja abierta la secuencia.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize, bool leaveOpen);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize, bool leaveOpen);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding? encoding = default, int bufferSize = -1, bool leaveOpen = false);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer, leaveOpen As Boolean)
Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)
Parámetros
- stream
- Stream
Secuencia en la que se va a escribir.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
- bufferSize
- Int32
Tamaño del búfer en bytes.
- leaveOpen
- Boolean
true
para dejar el flujo abierto después de desechar el objeto StreamWriter; de lo contrario, false
.
Excepciones
stream
o encoding
es null
.
bufferSize
es negativo.
No se puede escribir en stream
.
Ejemplos
En el ejemplo siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512, false))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512, False)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Comentarios
A menos que establezca leaveOpen
el parámetro en , el objeto llama al objeto proporcionado cuando se llama a true
StreamWriter Dispose() Stream StreamWriter.Dispose .
Este constructor inicializa la propiedad mediante el parámetro e Encoding inicializa la propiedad mediante el parámetro encoding
BaseStream stream
. No se restablece la posición de la secuencia. Para obtener información adicional, vea la Encoding propiedad .
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Se aplica a
StreamWriter(String, Boolean, Encoding, Int32)
Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada, con la codificación y el tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding, int bufferSize);
public StreamWriter (string path, bool append, System.Text.Encoding encoding, int bufferSize);
new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)
Parámetros
- path
- String
Ruta de acceso completa al archivo donde se puede escribir.
- append
- Boolean
Es true
para anexar datos al archivo; es false
para sobrescribir el archivo. Si el archivo especificado no existe, este parámetro no tiene ningún efecto y el constructor crea un nuevo archivo.
- encoding
- Encoding
Codificación de caracteres que se utilizará.
- bufferSize
- Int32
Tamaño del búfer en bytes.
Excepciones
path
es una cadena vacía ("").
o bien
path
contiene el nombre de un dispositivo del sistema (com1, com2, etc.).
path
o encoding
es null
.
bufferSize
es negativo.
path
incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.
El llamador no dispone del permiso requerido.
Acceso denegado.
La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
Ejemplos
En el ejemplo siguiente se muestra este constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8, 512)
writer.Write(textToAdd)
End Using
End Sub
End Module
Comentarios
Este constructor inicializa la propiedad Encoding mediante el parámetro de codificación . Para obtener información adicional, vea Encoding.
path
puede ser un nombre de archivo, incluido un archivo en un recurso compartido de convención de nomenclatura universal (UNC).
path
no es necesario que sea un archivo almacenado en disco; puede ser cualquier parte de un sistema que admita el acceso a través de secuencias.
Precaución
Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y que se pueda producir una excepción.
Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.
Consulte también
- Encoding
- E/S de archivos y secuencias
- Procedimiento para leer texto de un archivo
- Procedimiento para escribir texto en un archivo