Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Construtor 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.

Namespace:   System.IO
Assembly:  mscorlib (em mscorlib.dll)

public StreamWriter(
	string path
)

Parâmetros

path
Type: System.String

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

Exception Condition
UnauthorizedAccessException

O acesso foi negado.

ArgumentException

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

-ou-

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

ArgumentNullException

path é null.

DirectoryNotFoundException

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

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema. Por exemplo, em plataformas baseadas 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 inválida para o nome do arquivo, o nome do diretório ou a sintaxe de rótulo do volume.

SecurityException

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

This constructor creates a T:System.IO.StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its M:System.Text.Encoding.GetPreamble method returns an empty byte array. The default UTF-8 encoding for this constructor throws an exception on invalid bytes. This behavior is different from the behavior provided by the encoding object in the P:System.Text.Encoding.UTF8 property. To specify a BOM and determine whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as M:System.IO.StreamWriter.#ctor(System.String,System.Boolean,System.Text.Encoding).

The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share. If the file exists, it is overwritten; otherwise, a new file is created.

The path parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.

System_CAPS_cautionCuidado

When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

For a list of common I/O tasks, see Common I/O Tasks.

The following code example demonstrates this 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);
            }
        }
    }
}

FileIOPermission

for reading and writing files. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write

.NET Framework
Disponível desde 1.1
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Retornar ao início
Mostrar: