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 StreamReader (String, Encoding)

Inicializa uma nova instância da classe de StreamReader para o nome de arquivo especificado, com a codificação de caractere especificado.

Namespace:  System.IO
Assembly:  mscorlib (em mscorlib.dll)
public StreamReader(
	string path,
	Encoding encoding
)

Parâmetros

path
Tipo: System.String
O caminho completo do arquivo a ser lido.
encoding
Tipo: System.Text.Encoding
A codificação de caracteres usada.
ExceçãoCondição
ArgumentException

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

ArgumentNullException

path ou encoding são null.

FileNotFoundException

O arquivo não pode ser encontrado.

DirectoryNotFoundException

o caminho especificado é inválido, como estar em uma unidade unmapped.

NotSupportedException

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

Esse construtor inicializa a codificação como especificado pelo parâmetro de encoding , e o tamanho do buffer interno para 1024 bytes. O objeto de StreamReader tenta detectar a codificação olhando os primeiros três bytes de fluxo. Reconhece automaticamente Unicode UTF-8, pequeno - endian, e o texto Unicode grande - endian se inicia o arquivo com as marcas de pedido de byte apropriadas. Caso contrário, o usuário fornecido a codificação é usado. Consulte o método de Encoding.GetPreamble para mais informações.

O parâmetro de path pode ser um nome de arquivo, incluindo um arquivo em um compartilhamento de (UNC) convenção de nomenclatura universal de.

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ê cria um conjunto de caracteres por uma configuração cultural específico e recupera os mesmos caracteres com uma configuração cultural diferente, os caracteres não podem ser interpretable, e podem causar uma exceção a ser acionado.

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 de StreamReader .


private void getNewStreamReader() 
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 = 
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse = 
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file 
    StreamReader srAsciiFromFile = 
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse = 
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile = 
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"), 
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}


.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, 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 de sistema do NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.