StreamWriter Construtores

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.IO.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da StreamWriter classe.

Sobrecargas

Name	Description
StreamWriter(Stream)	Inicializa uma nova instância da StreamWriter classe para o fluxo especificado usando codificação UTF-8 e o tamanho padrão do buffer.
StreamWriter(String)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado usando a codificação e o tamanho do buffer por defeito.
StreamWriter(Stream, Encoding)	Inicializa uma nova instância da StreamWriter classe para o fluxo especificado usando a codificação especificada e o tamanho padrão do buffer.
StreamWriter(String, Boolean)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado usando a codificação e o tamanho do buffer por defeito. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.
StreamWriter(String, FileStreamOptions)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado, usando a codificação padrão e configurada com o objeto especificado FileStreamOptions .
StreamWriter(Stream, Encoding, Int32)	Inicializa uma nova instância da StreamWriter classe para o fluxo especificado usando a codificação e o tamanho do buffer especificados.
StreamWriter(String, Boolean, Encoding)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado usando a codificação e o tamanho padrão do buffer especificados. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.
StreamWriter(String, Encoding, FileStreamOptions)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado, usando a codificação especificada, e configurada com o objeto especificado FileStreamOptions .
StreamWriter(Stream, Encoding, Int32, Boolean)	Inicializa uma nova instância da StreamWriter classe para o fluxo especificado usando a codificação e o tamanho do buffer especificados, e opcionalmente deixa o fluxo aberto.
StreamWriter(String, Boolean, Encoding, Int32)	Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado no caminho especificado, usando a codificação e o tamanho do buffer especificados. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.

StreamWriter(Stream)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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 stream para escrever.

Exceções

ArgumentException

stream não é escrita.

ArgumentNullException

stream é null.

Exemplos

O seguinte exemplo de código demonstra este 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

Observações

Este construtor cria um StreamWriter com codificação UTF-8 sem um Byte-Order Mark (BOM), pelo que o seu GetPreamble método devolve um array de bytes vazio. A codificação UTF-8 por defeito para este construtor lança uma exceção em bytes inválidos. Este comportamento é diferente do comportamento fornecido pelo objeto codificador na Encoding.UTF8 propriedade. Para especificar se uma exceção é lançada sobre bytes inválidos, use um construtor que aceite um objeto de codificação como parâmetro, como StreamWriter. A BaseStream propriedade é inicializada usando o stream parâmetro. A posição do fluxo não é reiniciada.

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

Atenção

Quando compilas um conjunto de personagens com um determinado cenário cultural e recuperas essas mesmas personagens com um cenário cultural diferente, as personagens podem não ser interpretáveis e pode causar uma exceção.

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

Ver também

Aplica-se a

StreamWriter(String)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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 completo do ficheiro para escrever. path pode ser um nome de ficheiro.

Exceções

UnauthorizedAccessException

O acesso é negado.

ArgumentException

path é uma cadeia vazia ("").

-ou-

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

IOException

path inclui uma sintaxe incorreta ou inválida para nome de ficheiro, nome de diretório ou sintaxe de rótulos de volume.

SecurityException

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

Exemplos

O seguinte exemplo de código demonstra este 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

Observações

Este construtor cria um StreamWriter com codificação UTF-8 sem um Byte-Order Mark (BOM), pelo que o seu GetPreamble método devolve um array de bytes vazio. A codificação UTF-8 por defeito para este construtor lança uma exceção em bytes inválidos. Este comportamento é diferente do comportamento fornecido pelo objeto codificador na Encoding.UTF8 propriedade. Para especificar uma lista de materiais e determinar se uma exceção é lançada em bytes inválidos, use um construtor que aceite um objeto de codificação como parâmetro, como StreamWriter(String, Boolean, Encoding).

O path parâmetro pode ser um nome de ficheiro, incluindo um ficheiro numa partilha da Convenção Universal de Nomes (UNC). Se o ficheiro existir, é sobrescrito; caso contrário, é criado um novo ficheiro.

O path parâmetro não é necessário ser um ficheiro armazenado em disco; pode ser qualquer parte de um sistema que suporte acesso através de fluxos.

Atenção

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

Ver também

Aplica-se a

StreamWriter(Stream, Encoding)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);

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 stream para escrever.

encoding: Encoding

A codificação de caracteres a usar.

Exceções

ArgumentNullException

stream ou encoding é null.

ArgumentException

stream não é escrita.

Exemplos

O exemplo seguinte demonstra este 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

Observações

Este construtor inicializa a Encoding propriedade usando o parâmetro de codificação, e a BaseStream propriedade usando o parâmetro de fluxo. A posição do fluxo não é reiniciada. Para obter informações adicionais, consulte Encoding.

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

Atenção

Quando se compila um conjunto de personagens com um determinado cenário cultural e se recuperam essas mesmas personagens com um cenário cultural diferente, as personagens podem não ser interpretáveis e podem causar uma exceção.

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

Ver também

Aplica-se a

StreamWriter(String, Boolean)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado usando a codificação e o tamanho do buffer por defeito. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.

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 completo do ficheiro para escrever.

append: Boolean

true adicionar dados ao ficheiro; false para sobrescrever o ficheiro. Se o ficheiro especificado não existir, este parâmetro não tem efeito, e o construtor cria um novo ficheiro.

Exceções

UnauthorizedAccessException

O acesso é negado.

ArgumentException

path está vazio.

-ou-

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

IOException

path inclui uma sintaxe incorreta ou inválida para nome de ficheiro, nome de diretório ou sintaxe de rótulos de volume.

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

SecurityException

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

Exemplos

O seguinte exemplo de código demonstra este 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

Observações

Este construtor cria um StreamWriter com codificação UTF-8 sem um Byte-Order Mark (BOM), pelo que o seu GetPreamble método devolve um array de bytes vazio. A codificação UTF-8 por defeito para este construtor lança uma exceção em bytes inválidos. Este comportamento é diferente do comportamento fornecido pelo objeto codificador na Encoding.UTF8 propriedade. Para especificar uma lista de materiais e determinar se uma exceção é lançada em bytes inválidos, use um construtor que aceite um objeto de codificação como parâmetro, como StreamWriter(String, Boolean, Encoding).

O path parâmetro pode ser um nome de ficheiro, incluindo um ficheiro numa partilha da Convenção Universal de Nomes (UNC).

O path parâmetro não é necessário ser um ficheiro armazenado em disco; pode ser qualquer parte de um sistema que suporte acesso através de fluxos.

Atenção

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

Ver também

Aplica-se a

StreamWriter(String, FileStreamOptions)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o ficheiro 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 completo do ficheiro para escrever.

options: FileStreamOptions

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

Exceções

ArgumentNullException

options é null .

ArgumentException

path não é escrita.

Ver também

Aplica-se a

StreamWriter(Stream, Encoding, Int32)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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 stream para escrever.

encoding: Encoding

A codificação de caracteres a usar.

bufferSize: Int32

O tamanho do buffer, em caracteres.

Exceções

ArgumentNullException

stream ou encoding é null.

ArgumentOutOfRangeException

bufferSize é menor ou igual a zero, exceto -1, que pode indicar o tamanho padrão do buffer.

ArgumentException

stream não é escrita.

Exemplos

O exemplo seguinte demonstra este 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

Observações

Este 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 é reiniciada. Para obter informações adicionais, consulte Encoding.

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

Atenção

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

Ver também

Aplica-se a

StreamWriter(String, Boolean, Encoding)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado usando a codificação e o tamanho padrão do buffer especificados. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.

public:
 StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);

public StreamWriter(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 completo do ficheiro para escrever.

append: Boolean

true adicionar dados ao ficheiro; false para sobrescrever o ficheiro. Se o ficheiro especificado não existir, este parâmetro não tem efeito, e o construtor cria um novo ficheiro.

encoding: Encoding

A codificação de caracteres a usar.

Exceções

UnauthorizedAccessException

O acesso é negado.

ArgumentException

path está vazio.

-ou-

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

IOException

path inclui uma sintaxe incorreta ou inválida para nome de ficheiro, nome de diretório ou sintaxe de rótulos de volume.

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

SecurityException

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

Exemplos

O exemplo seguinte demonstra este 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

Observações

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

path pode ser um nome de ficheiro, incluindo um ficheiro numa partilha da Convenção de Nomes Universal (UNC).

path não é necessário que seja um ficheiro armazenado em disco; Pode ser qualquer parte de um sistema que suporte acesso através de streams.

Atenção

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

Ver também

Aplica-se a

StreamWriter(String, Encoding, FileStreamOptions)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o ficheiro 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);

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 completo do ficheiro para escrever.

encoding: Encoding

A codificação de caracteres a usar.

options: FileStreamOptions

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

Exceções

ArgumentNullException

options é null .

ArgumentException

path não é escrita.

Ver também

Aplica-se a

StreamWriter(Stream, Encoding, Int32, Boolean)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

encoding: Encoding

A codificação de caracteres a usar.

bufferSize: Int32

O tamanho do buffer, em caracteres.

leaveOpen: Boolean

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

Exceções

ArgumentNullException

stream ou encoding é null.

ArgumentOutOfRangeException

bufferSize é menor ou igual a zero, exceto -1, que pode indicar o tamanho padrão do buffer.

ArgumentException

stream não é escrita.

Exemplos

O exemplo seguinte demonstra este 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

Observações

A menos que definas o leaveOpen parâmetro para true, o StreamWriter objeto chama Dispose() o objeto fornecido Stream quando StreamWriter.Dispose é chamado.

Este 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 é reiniciada. Para informações adicionais, consulte a propriedade Encoding .

Atenção

Aplica-se a

StreamWriter(String, Boolean, Encoding, Int32)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Inicializa uma nova instância da StreamWriter classe para o ficheiro especificado no caminho especificado, usando a codificação e o tamanho do buffer especificados. Se o ficheiro existir, pode ser sobrescrito ou acrescentado. Se o ficheiro não existir, este construtor cria um novo ficheiro.

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);

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 completo do ficheiro para escrever.

append: Boolean

true adicionar dados ao ficheiro; false para sobrescrever o ficheiro. Se o ficheiro especificado não existir, este parâmetro não tem efeito, e o construtor cria um novo ficheiro.

encoding: Encoding

A codificação de caracteres a usar.

bufferSize: Int32

O tamanho do buffer, em caracteres.

Exceções

ArgumentException

path é uma cadeia vazia ("").

-ou-

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

ArgumentNullException

path ou encoding é null.

ArgumentOutOfRangeException

bufferSize é menor ou igual a zero, exceto -1, que pode indicar o tamanho padrão do buffer.

IOException

path inclui uma sintaxe incorreta ou inválida para nome de ficheiro, nome de diretório ou sintaxe de rótulos de volume.

SecurityException

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

UnauthorizedAccessException

O acesso é negado.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

Exemplos

O exemplo seguinte demonstra este 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

Observações

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

path pode ser um nome de ficheiro, incluindo um ficheiro numa partilha da Convenção de Nomes Universal (UNC).

path não é necessário que seja um ficheiro armazenado em disco; Pode ser qualquer parte de um sistema que suporte acesso através de streams.

Atenção

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

Ver também

Aplica-se a

Comentários

Esta página foi útil?