File.Create Método

Definição

Cria ou substitui um arquivo no caminho especificado.

Sobrecargas

Create(String)

Cria ou substitui um arquivo no caminho especificado.

Create(String, Int32)

Cria ou substitui um arquivo no caminho especificado usando o tamanho do 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 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

FileStream

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 com mais de 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());
        }
    }
}
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 ele 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)

Cria ou substitui um arquivo no caminho especificado usando 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 arquivo a ser criado.

bufferSize
Int32

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

Retornos

FileStream

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);
            }
        }
    }
}
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 ela 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

FileStream

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 ela 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

FileStream

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 ela 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