StreamWriter Constructores

Definición

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

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

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

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

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

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

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

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

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

Se aplica a