File.Create Método

Definição

Cria ou trunca e substitui um arquivo no caminho especificado.

Sobrecargas

Create(String)

Cria ou trunca e substitui um arquivo no caminho especificado.

Create(String, Int32)

Cria ou trunca e substitui um arquivo no caminho especificado, especificando um tamanho de buffer.

Create(String, Int32, FileOptions)

Cria ou substitui um arquivo no caminho especificado usando o tamanho do buffer e opções que descrevem como criar ou substituir o arquivo.

Create(String, Int32, FileOptions, FileSecurity)

Cria ou substitui um arquivo no caminho especificado usando o tamanho do buffer, opções que descrevem como criar ou substituir o arquivo e um valor que determina o controle de acesso e a segurança de auditoria para o arquivo.

Create(String)

Cria ou trunca e substitui um arquivo 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 arquivo a ser criado.

Retornos

Um FileStream que fornece acesso de leitura/gravação para o arquivo especificado em path.

Exceções

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

- ou -

path especificou um arquivo somente leitura.

- ou -

path especificou um arquivo que está oculto.

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

path é null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

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

Ocorreu um erro de E/S ao criar o arquivo.

path está em um formato inválido.

Exemplos

O exemplo a seguir cria um arquivo no caminho especificado, grava algumas informações no arquivo e lê do arquivo.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
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

Comentários

O FileStream objeto criado por esse método tem um valor padrão FileShare de None; nenhum outro processo ou código pode acessar o arquivo criado até que o identificador de arquivo original seja fechado.

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

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

Se o arquivo especificado não existir, ele será criado; se existir e não for somente leitura, o conteúdo será excluído e substituído.

Por padrão, o acesso completo de leitura/gravação a novos arquivos é concedido a todos os usuários. O arquivo é aberto com acesso de leitura/gravação e deve ser fechado antes de ser aberto por outro aplicativo.

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

Confira também

Aplica-se a

Create(String, Int32)

Cria ou trunca e substitui um arquivo no caminho especificado, especificando um tamanho de 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 arquivo a ser criado.

bufferSize
Int32

O número de bytes armazenados em buffer para leituras e gravações no arquivo.

Retornos

Um FileStream com o tamanho do buffer especificado que fornece acesso de leitura/gravação para o arquivo especificado em path.

Exceções

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

- ou -

path especificou um arquivo somente leitura.

- ou -

path especificou um arquivo que está oculto.

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

path é null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

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

Ocorreu um erro de E/S ao criar o arquivo.

path está em um formato inválido.

Exemplos

O exemplo a seguir cria um arquivo com o tamanho do buffer especificado.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
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

Comentários

O FileStream objeto criado por esse método tem um valor padrão FileShare de None; nenhum outro processo ou código pode acessar o arquivo criado até que o identificador de arquivo original seja fechado.

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

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

Por padrão, o acesso completo de leitura/gravação a novos arquivos é concedido a todos os usuários. O arquivo é aberto com acesso de leitura/gravação e deve ser fechado antes de ser aberto por outro aplicativo.

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

Confira também

Aplica-se a

Create(String, Int32, FileOptions)

Cria ou substitui um arquivo no caminho especificado usando o tamanho do buffer e opções que descrevem como criar ou substituir o arquivo.

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 arquivo a ser criado.

bufferSize
Int32

O número de bytes armazenados em buffer para leituras e gravações no arquivo.

options
FileOptions

Um dos valores de FileOptions que descreve como criar ou substituir o arquivo.

Retornos

Um novo arquivo com o tamanho do buffer especificado.

Exceções

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

- ou -

path especificou um arquivo somente leitura.

- ou -

path especificou um arquivo que está oculto.

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

path é null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

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

Ocorreu um erro de E/S ao criar o arquivo.

path está em um formato inválido.

Comentários

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

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

Por padrão, o acesso completo de leitura/gravação a novos arquivos é concedido a todos os usuários. O arquivo é aberto com acesso de leitura/gravação e deve ser fechado antes de ser aberto por outro aplicativo.

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

Aplica-se a

Create(String, Int32, FileOptions, FileSecurity)

Cria ou substitui um arquivo no caminho especificado usando o tamanho do buffer, opções que descrevem como criar ou substituir o arquivo e um valor que determina o controle de acesso e a segurança de auditoria para o arquivo.

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 arquivo a ser criado.

bufferSize
Int32

O número de bytes armazenados em buffer para leituras e gravações no arquivo.

options
FileOptions

Um dos valores de FileOptions que descreve como criar ou substituir o arquivo.

fileSecurity
FileSecurity

Um objeto FileSecurity que determina o controle de acesso e a segurança de auditoria para o arquivo.

Retornos

Um novo arquivo com o tamanho do buffer, as opções de arquivo e a segurança de arquivo especificados.

Exceções

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

- ou -

path especificou um arquivo somente leitura.

- ou -

path especificou um arquivo que está oculto.

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

path é null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

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

Ocorreu um erro de E/S ao criar o arquivo.

path está em um formato inválido.

Comentários

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

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

Por padrão, o acesso completo de leitura/gravação a novos arquivos é concedido a todos os usuários. O arquivo é aberto com acesso de leitura/gravação e deve ser fechado antes de ser aberto por outro aplicativo.

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

Importante

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

Aplica-se a