Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Construtor StreamWriter (String)

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

Namespace:  System.IO
Assembly:  mscorlib (em mscorlib.dll)
public StreamWriter(
	string path
)

Parâmetros

path
Tipo: System.String
O caminho do arquivo completo a escrever. path pode ser um nome de arquivo.
ExceçãoCondição
UnauthorizedAccessException

O acesso foi negado.

ArgumentException

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

-ou-

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está em uma unidade unmapped).

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema. Por exemplo, em plataformas baseados no Windows, os caminhos não devem exceder 248 caracteres, e os nomes de arquivo não devem exceder 260 caracteres.

IOException

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

SecurityException

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

Esse construtor cria StreamWriter com codificação UTF-8 sem uma marca de pedido de byte (BOM), para que seus retornos de método GetPreamble uma matriz vazia de bytes. A codificação UTF-8 padrão para esse construtor lança uma exceção em bytes inválidos. Esse comportamento é diferente do comportamento fornecido pelo objeto de codificação na propriedade de Encoding.UTF8 . Para especificar um BOM e determinar se uma exceção é lançada em bytes inválidos, use um construtor que aceita um objeto de codificação como um parâmetro, como StreamWriter(String, Boolean, Encoding).

O parâmetro de path pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento de (UNC) a convenção de nomenclatura universal de. Se o arquivo existir, ele será substituído; se não, um novo arquivo é criado.

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

Observação de cuidadoCuidado

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 I/O, consulte Tarefas comuns de E/S.

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


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft. Todos os direitos reservados.