WriteAllLines Método (String, String[], Encoding)
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

Método File.WriteAllLines (String, String[], Encoding)

 

Cria um novo arquivo, grava a matriz de cadeia de caracteres especificada no arquivo usando a codificação especificada e, em seguida, fecha o arquivo.

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

public static void WriteAllLines(
	string path,
	string[] contents,
	Encoding encoding
)

Parâmetros

path

O arquivo para gravar.

contents

A matriz de cadeia de caracteres para gravar o arquivo.

encoding

Uma Encoding objeto que representa a codificação de caractere aplicado à matriz de cadeia de caracteres.

Exception Condition
ArgumentException

path é uma cadeia de caracteres de comprimento zero, contém somente espaço em branco ou contém um ou mais caracteres inválidos, conforme definido pelo InvalidPathChars.

ArgumentNullException

O path ou contents é null.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.Por exemplo, em plataformas com base no Windows, os caminhos devem ter menos que 248 caracteres e os nomes de arquivo devem ter menos que 260 caracteres.

DirectoryNotFoundException

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

IOException

Um erro de E/S ocorreu ao abrir o arquivo.

UnauthorizedAccessException

path especificado um arquivo é somente leitura.

-ou-

Esta operação não é suportada na plataforma atual.

-ou-

path especificado um diretório.

-ou-

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

NotSupportedException

path está em um formato inválido.

SecurityException

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

Se o arquivo de destino já existir, ele será substituído.

Devido a uma matriz de cadeia de caracteres e um caminho de arquivo, esse método abre o arquivo especificado, grava a matriz de cadeia de caracteres para o arquivo usando a codificação especificada e, em seguida, fecha o arquivo.

O exemplo de código a seguir demonstra o uso do WriteAllLines método para gravar texto em um arquivo.Neste exemplo um arquivo é criado, se ele ainda não existir e o texto é adicionado a ele.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}

FileIOPermission

for access to write to a file or directory.Associated enumeration: FileIOPermissionAccess.Write

.NET Framework
Disponível desde 2.0
Retornar ao topo
Mostrar:
© 2016 Microsoft