Compartilhar via


StreamWriter Construtores

Definição

Inicializa uma nova instância da classe StreamWriter.

Sobrecargas

StreamWriter(Stream)

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando a codificação UTF-8 e o tamanho do buffer padrão.

StreamWriter(String)

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando o tamanho do buffer e a codificação padrão.

StreamWriter(Stream, Encoding)

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando a codificação especificada e o tamanho do buffer padrão.

StreamWriter(String, Boolean)

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando o tamanho do buffer e a codificação padrão. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

StreamWriter(String, FileStreamOptions)

Inicializa uma nova instância da StreamWriter classe para o arquivo especificado, usando a codificação padrão e configurada com o objeto especificado FileStreamOptions .

StreamWriter(Stream, Encoding, Int32)

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando o tamanho do buffer e a codificação especificados.

StreamWriter(String, Boolean, Encoding)

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando a codificação especificada e o tamanho do buffer padrão. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

StreamWriter(String, Encoding, FileStreamOptions)

Inicializa uma nova instância da StreamWriter classe para o arquivo especificado, usando a codificação especificada e configurada com o objeto especificado FileStreamOptions .

StreamWriter(Stream, Encoding, Int32, Boolean)

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando o tamanho do buffer e a codificação especificados e opcionalmente deixa o fluxo aberto.

StreamWriter(String, Boolean, Encoding, Int32)

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado no caminho especificado usando a codificação especificada e o tamanho do buffer. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

StreamWriter(Stream)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando a codificação UTF-8 e o tamanho do buffer padrão.

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

O fluxo para gravação.

Exceções

stream não é gravável.

stream é null.

Exemplos

O exemplo de código a seguir demonstra esse construtor.

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

Comentários

Esse construtor cria um StreamWriter com codificação UTF-8 sem uma BOM (marca de Byte-Order), portanto, seu GetPreamble método retorna uma matriz de bytes vazia. A codificação UTF-8 padrão para esse construtor gera uma exceção em bytes inválidos. Esse comportamento é diferente do comportamento fornecido pelo objeto de codificação na Encoding.UTF8 propriedade . Para especificar se uma exceção é gerada em bytes inválidos, use um construtor que aceite um objeto de codificação como um parâmetro, como StreamWriter. A BaseStream propriedade é inicializada usando o stream parâmetro . A posição do fluxo não é redefinida.

O StreamWriter objeto chama Dispose() no objeto fornecido Stream quando StreamWriter.Dispose é chamado.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera os mesmos caracteres com uma configuração cultural diferente, os caracteres talvez não sejam interpretáveis e poderiam causar uma exceção a ser lançada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(String)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando o tamanho do buffer e a codificação padrão.

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

O caminho de arquivo completo no qual gravar. path pode ser um nome de arquivo.

Exceções

path é uma cadeia de caracteres vazia ("").

- ou -

path contém o nome de um dispositivo de sistema (com1, com2 e assim por diante).

path é null.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

path inclui uma sintaxe incorreta ou inválida para o nome do arquivo, o nome do diretório ou a sintaxe de rótulo do volume.

O chamador não tem a permissão necessária.

Exemplos

O exemplo de código a seguir demonstra esse construtor.

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

Comentários

Esse construtor cria um StreamWriter com codificação UTF-8 sem uma BOM (marca de Byte-Order), portanto, seu GetPreamble método retorna uma matriz de bytes vazia. A codificação UTF-8 padrão para esse construtor gera uma exceção em bytes inválidos. Esse comportamento é diferente do comportamento fornecido pelo objeto de codificação na Encoding.UTF8 propriedade . Para especificar uma BOM e determinar se uma exceção é gerada em bytes inválidos, use um construtor que aceite um objeto de codificação como um parâmetro, como StreamWriter(String, Boolean, Encoding).

O path parâmetro pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento UNC (Convenção Universal de Nomenclatura). Se o arquivo existir, ele será substituído; caso contrário, um novo arquivo será criado.

O path parâmetro não precisa ser um arquivo armazenado em disco; ele pode ser qualquer parte de um sistema que dê suporte ao acesso usando fluxos.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera os mesmos caracteres com uma configuração cultural diferente, os caracteres talvez não sejam interpretáveis e poderiam causar uma exceção a ser lançada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(Stream, Encoding)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando a codificação especificada e o tamanho do buffer padrão.

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

O fluxo para gravação.

encoding
Encoding

A codificação de caracteres a ser usada.

Exceções

stream ou encoding é null.

stream não é gravável.

Exemplos

O exemplo a seguir demonstra esse construtor.

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

Comentários

Esse construtor inicializa a Encoding propriedade usando o parâmetro de codificação e a BaseStream propriedade usando o parâmetro stream. A posição do fluxo não é redefinida. Para obter mais informações, consulte: Encoding.

O StreamWriter objeto chama Dispose() no objeto fornecido Stream quando StreamWriter.Dispose é chamado.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(String, Boolean)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando o tamanho do buffer e a codificação padrão. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

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

O caminho de arquivo completo no qual gravar.

append
Boolean

true para acrescentar dados ao arquivo; false para substituir o arquivo. Se o arquivo especificado não existir, esse parâmetro não terá efeito e o construtor criará um novo arquivo.

Exceções

path está vazio.

- ou -

path contém o nome de um dispositivo de sistema (com1, com2 e assim por diante).

path é null.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

path inclui uma sintaxe incorreta ou inválida para o nome do arquivo, o nome do diretório ou a sintaxe de rótulo do volume.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

O chamador não tem a permissão necessária.

Exemplos

O exemplo de código a seguir demonstra esse construtor.

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

Comentários

Esse construtor cria um StreamWriter com codificação UTF-8 sem uma MARCA de Byte-Order (BOM), de modo que seu GetPreamble método retorna uma matriz de bytes vazia. A codificação UTF-8 padrão para esse construtor gera uma exceção em bytes inválidos. Esse comportamento é diferente do comportamento fornecido pelo objeto de codificação na Encoding.UTF8 propriedade . Para especificar uma BOM e determinar se uma exceção é gerada em bytes inválidos, use um construtor que aceite um objeto de codificação como um parâmetro, como StreamWriter(String, Boolean, Encoding).

O path parâmetro pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento UNC (Convenção Universal de Nomenclatura).

O path parâmetro não é necessário para ser um arquivo armazenado em disco; ele pode ser qualquer parte de um sistema que dê suporte ao acesso usando fluxos.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(String, FileStreamOptions)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o arquivo especificado, usando a codificação padrão e configurada com o objeto especificado FileStreamOptions .

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

O caminho de arquivo completo no qual gravar.

options
FileStreamOptions

Um objeto que especifica as opções de configuração para o subjacente FileStream.

Exceções

options é null .

stream não é gravável.

Confira também

Aplica-se a

StreamWriter(Stream, Encoding, Int32)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando o tamanho do buffer e a codificação 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

O fluxo para gravação.

encoding
Encoding

A codificação de caracteres a ser usada.

bufferSize
Int32

O tamanho do buffer, em bytes.

Exceções

stream ou encoding é null.

bufferSize é negativo.

stream não é gravável.

Exemplos

O exemplo a seguir demonstra esse construtor.

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

Comentários

Esse construtor inicializa a Encoding propriedade usando o encoding parâmetro e a BaseStream propriedade usando o stream parâmetro . A posição do fluxo não é redefinida. Para obter mais informações, consulte: Encoding.

O StreamWriter objeto chama Dispose() no objeto fornecido Stream quando StreamWriter.Dispose é chamado.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(String, Boolean, Encoding)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado usando a codificação especificada e o tamanho do buffer padrão. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

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

O caminho de arquivo completo no qual gravar.

append
Boolean

true para acrescentar dados ao arquivo; false para substituir o arquivo. Se o arquivo especificado não existir, esse parâmetro não terá efeito e o construtor criará um novo arquivo.

encoding
Encoding

A codificação de caracteres a ser usada.

Exceções

path está vazio.

- ou -

path contém o nome de um dispositivo de sistema (com1, com2 e assim por diante).

path é null.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

path inclui uma sintaxe incorreta ou inválida para o nome do arquivo, o nome do diretório ou a sintaxe de rótulo do volume.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

O chamador não tem a permissão necessária.

Exemplos

O exemplo a seguir demonstra esse construtor.

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

Comentários

Esse construtor inicializa a Encoding propriedade usando o parâmetro de codificação. Para obter mais informações, consulte: Encoding.

path pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento UNC (Convenção Universal de Nomenclatura).

path não é necessário ser um arquivo armazenado em disco; pode ser qualquer parte de um sistema que dê suporte ao acesso por meio de fluxos.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

StreamWriter(String, Encoding, FileStreamOptions)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o arquivo especificado, usando a codificação especificada e configurada com o objeto especificado FileStreamOptions .

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

O caminho de arquivo completo no qual gravar.

encoding
Encoding

A codificação de caracteres a ser usada.

options
FileStreamOptions

Um objeto que especifica as opções de configuração para o subjacente FileStream.

Exceções

options é null .

stream não é gravável.

Confira também

Aplica-se a

StreamWriter(Stream, Encoding, Int32, Boolean)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o fluxo especificado usando o tamanho do buffer e a codificação especificados e opcionalmente deixa o fluxo aberto.

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

O fluxo para gravação.

encoding
Encoding

A codificação de caracteres a ser usada.

bufferSize
Int32

O tamanho do buffer, em bytes.

leaveOpen
Boolean

true para deixar o fluxo aberto após o objeto StreamWriter ser descartado; caso contrário, false.

Exceções

stream ou encoding é null.

bufferSize é negativo.

stream não é gravável.

Exemplos

O exemplo a seguir demonstra esse construtor.

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

Comentários

A menos que você defina o leaveOpen parâmetro como true, o StreamWriter objeto chama Dispose() no objeto fornecido Stream quando StreamWriter.Dispose é chamado.

Esse construtor inicializa a Encoding propriedade usando o encoding parâmetro e inicializa a BaseStream propriedade usando o stream parâmetro . A posição do fluxo não é redefinida. Para obter informações adicionais, consulte a Encoding propriedade .

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Aplica-se a

StreamWriter(String, Boolean, Encoding, Int32)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Inicializa uma nova instância da classe StreamWriter para o arquivo especificado no caminho especificado usando a codificação especificada e o tamanho do buffer. Se o arquivo existir, ele poderá ser substituído ou dados poderão ser acrescentados a ele. Se o arquivo não existir, esse construtor criará um novo arquivo.

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

O caminho de arquivo completo no qual gravar.

append
Boolean

true para acrescentar dados ao arquivo; false para substituir o arquivo. Se o arquivo especificado não existir, esse parâmetro não terá efeito e o construtor criará um novo arquivo.

encoding
Encoding

A codificação de caracteres a ser usada.

bufferSize
Int32

O tamanho do buffer, em bytes.

Exceções

path é uma cadeia de caracteres vazia ("").

- ou -

path contém o nome de um dispositivo de sistema (com1, com2 e assim por diante).

path ou encoding é null.

bufferSize é negativo.

path inclui uma sintaxe incorreta ou inválida para o nome do arquivo, o nome do diretório ou a sintaxe de rótulo do volume.

O chamador não tem a permissão necessária.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

Exemplos

O exemplo a seguir demonstra esse construtor.

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

Comentários

Esse construtor inicializa a Encoding propriedade usando o parâmetro de codificação . Para obter mais informações, consulte: Encoding.

path pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento UNC (Convenção Universal de Nomenclatura).

path não é necessário ser um arquivo armazenado em disco; pode ser qualquer parte de um sistema que dê suporte ao acesso por meio de fluxos.

Cuidado

Quando você compila um conjunto de caracteres com uma configuração cultural específica e recupera esses mesmos caracteres com uma configuração cultural diferente, os caracteres podem não ser interpretáveis e podem fazer com que uma exceção seja gerada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a