File.Create Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

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)

Origem:

File.cs

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

FileStream

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

Exceções

UnauthorizedAccessException

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.

ArgumentException

.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().

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo
• Como ler e gravar em um arquivo de dados recém-criado

Create(String, Int32)

Origem:

File.cs

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

FileStream

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

Exceções

UnauthorizedAccessException

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.

ArgumentException

.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().

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo
• Como ler e gravar em um arquivo de dados recém-criado

Create(String, Int32, FileOptions)

Origem:

File.cs

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

UnauthorizedAccessException

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.

ArgumentException

.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().

ArgumentNullException

path é null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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.