StreamWriter Constructores

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.IO.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: mscorlib.dll

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

ArgumentException

No se puede escribir en stream.

ArgumentNullException

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

UnauthorizedAccessException

Acceso denegado.

ArgumentException

path es una cadena vacía ("").

o bien path contiene el nombre de un dispositivo del sistema (com1, com2, etc.).

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

IOException

path incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.

SecurityException

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

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

ArgumentNullException

stream o encoding es null.

ArgumentException

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

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

UnauthorizedAccessException

Acceso denegado.

ArgumentException

path está vacía.

o bien path contiene el nombre de un dispositivo del sistema (com1, com2, etc.).

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

path incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

SecurityException

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

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

ArgumentNullException

options es null .

ArgumentException

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

ArgumentNullException

stream o encoding es null.

ArgumentOutOfRangeException

bufferSize es negativo.

ArgumentException

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

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

UnauthorizedAccessException

Acceso denegado.

ArgumentException

path está vacía.

o bien path contiene el nombre de un dispositivo del sistema (com1, com2, etc.).

ArgumentNullException

path es null.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

path incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

SecurityException

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

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

ArgumentNullException

options es null .

ArgumentException

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

ArgumentNullException

stream o encoding es null.

ArgumentOutOfRangeException

bufferSize es negativo.

ArgumentException

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

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

ArgumentException

path es una cadena vacía ("").

o bien path contiene el nombre de un dispositivo del sistema (com1, com2, etc.).

ArgumentNullException

path o encoding es null.

ArgumentOutOfRangeException

bufferSize es negativo.

IOException

path incluye una sintaxis no correcta o no válida para el nombre de archivo, el nombre de directorio o la etiqueta de volumen.

SecurityException

El llamador no dispone del permiso requerido.

UnauthorizedAccessException

Acceso denegado.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

PathTooLongException

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

Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.

Consulte también

Se aplica a

StreamWriter Constructores

Definición

Sobrecargas

StreamWriter(Stream)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(Stream, Encoding)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(String, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(String, FileStreamOptions)

Parámetros

Excepciones

Consulte también

Se aplica a

StreamWriter(Stream, Encoding, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(String, Boolean, Encoding)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamWriter(String, Encoding, FileStreamOptions)

Parámetros

Excepciones

Consulte también

Se aplica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

StreamWriter(String, Boolean, Encoding, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales