File.Create Método

Definição

Espaço de Nomes:: System.IO

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

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.FileSystem.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.

Cria, ou trunca e sobrescreve, um ficheiro no caminho especificado.

Sobrecargas

Name	Description
Create(String)	Cria, ou trunca e sobrescreve, um ficheiro no caminho especificado.
Create(String, Int32)	Cria, ou trunca e sobrescreve, um ficheiro no caminho especificado, especificando o tamanho do buffer.
Create(String, Int32, FileOptions)	Cria ou sobrescreve um ficheiro no caminho especificado, especificando um tamanho de buffer e opções que descrevem como criar ou sobrescrever o ficheiro.
Create(String, Int32, FileOptions, FileSecurity)	Cria ou sobrescreve um ficheiro no caminho especificado, especificando um tamanho de buffer, opções que descrevem como criar ou sobrescrever o ficheiro, e um valor que determina o controlo de acesso e a segurança de auditoria do ficheiro.

Create(String)

Cria, ou trunca e sobrescreve, um ficheiro no caminho especificado.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);

public static System.IO.FileStream Create(string path);

static member Create : string -> System.IO.FileStream

Public Shared Function Create (path As String) As FileStream

Parâmetros

path: String

O caminho e o nome do ficheiro a criar.

Devoluções

FileStream

A FileStream que fornece acesso de leitura/escrita ao ficheiro especificado em path.

Exceções

UnauthorizedAccessException

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

-ou-

path especificou um ficheiro que é apenas leitura.

-ou-

path especificou um ficheiro que está oculto.

ArgumentException

.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

Ocorreu um erro de I/O durante a criação do ficheiro.

NotSupportedException

path está num formato inválido.

Exemplos

O exemplo seguinte cria um ficheiro no caminho especificado, escreve alguma informação no ficheiro e lê a partir do ficheiro.

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

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

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Observações

O FileStream objeto criado por este método tem um valor por defeito FileShare de None; nenhum outro processo ou código pode aceder ao ficheiro criado até que o handle original do ficheiro seja fechado.

Este método é equivalente Create(String, Int32) à sobrecarga do método usando o tamanho padrão do buffer de 4.096 bytes.

O path parâmetro pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual. Para obter o diretório de trabalho atual, veja GetCurrentDirectory.

Se o ficheiro especificado não existir, ele é criado; Se existir e não for apenas leitura, o conteúdo é eliminado e sobrescrevido.

Por defeito, é concedido acesso total de leitura/escrita a novos ficheiros a todos os utilizadores. O ficheiro é aberto com acesso de leitura/escrita e deve ser encerrado antes de poder ser aberto por outra aplicação.

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

Ver também

Aplica-se a

Create(String, Int32)

Cria, ou trunca e sobrescreve, um ficheiro no caminho especificado, especificando o tamanho do buffer.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);

public static System.IO.FileStream Create(string path, int bufferSize);

static member Create : string * int -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

Parâmetros

path: String

O caminho e o nome do ficheiro a criar.

bufferSize: Int32

O número de bytes armazenados em buffer para leituras e escritas no ficheiro.

Devoluções

FileStream

A FileStream com o tamanho de buffer especificado que fornece acesso de leitura/escrita ao ficheiro especificado em path.

Exceções

UnauthorizedAccessException

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

-ou-

path especificou um ficheiro que é apenas leitura.

-ou-

path especificou um ficheiro que está oculto.

ArgumentException

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

Ocorreu um erro de I/O durante a criação do ficheiro.

NotSupportedException

path está num formato inválido.

Exemplos

O exemplo seguinte cria um ficheiro com o tamanho do buffer especificado.

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

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

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024))
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create(path, 1024)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Observações

Este método é equivalente à FileStream(String, FileMode, FileAccess, FileShare, Int32) sobrecarga do construtor. Se o ficheiro especificado não existir, ele é criado; se existir e não for apenas leitura, o conteúdo é substituído.

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

Ver também

Aplica-se a

Create(String, Int32, FileOptions)

Cria ou sobrescreve um ficheiro no caminho especificado, especificando um tamanho de buffer e opções que descrevem como criar ou sobrescrever o ficheiro.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);

public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options);

static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

Parâmetros

path: String

O caminho e o nome do ficheiro a criar.

bufferSize: Int32

O número de bytes armazenados em buffer para leituras e escritas no ficheiro.

options: FileOptions

Um dos FileOptions valores que descreve como criar ou sobrescrever o ficheiro.

Devoluções

FileStream

Um ficheiro novo com o tamanho do buffer especificado.

Exceções

UnauthorizedAccessException

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

-ou-

path especificou um ficheiro que é apenas leitura.

-ou-

path especificou um ficheiro que está oculto.

ArgumentException

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

Ocorreu um erro de I/O durante a criação do ficheiro.

NotSupportedException

path está num formato inválido.

Observações

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

Aplica-se a

Create(String, Int32, FileOptions, FileSecurity)

Cria ou sobrescreve um ficheiro no caminho especificado, especificando um tamanho de buffer, opções que descrevem como criar ou sobrescrever o ficheiro, e um valor que determina o controlo de acesso e a segurança de auditoria do ficheiro.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);

static member Create : string * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream

Parâmetros

path: String

O caminho e o nome do ficheiro a criar.

bufferSize: Int32

O número de bytes armazenados em buffer para leituras e escritas no ficheiro.

options: FileOptions

Um dos FileOptions valores que descreve como criar ou sobrescrever o ficheiro.

fileSecurity: FileSecurity

Um FileSecurity objeto que determina o controlo de acesso e a segurança da auditoria do ficheiro.

Devoluções

FileStream

Um novo ficheiro com o tamanho do buffer especificado, opções de ficheiro e segurança do ficheiro.

Exceções

UnauthorizedAccessException

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

-ou-

path especificou um ficheiro que é apenas leitura.

-ou-

path especificou um ficheiro que está oculto.

ArgumentException

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

Ocorreu um erro de I/O durante a criação do ficheiro.

NotSupportedException

path está num formato inválido.

Observações

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

Importante

Este método foi portado para .NET Core 3.1 na seguinte forma: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Aplica-se a

Comentários

Esta página foi útil?