Partager via


File.Create Méthode

Définition

Crée ou tronque et remplace un fichier dans le chemin spécifié.

Surcharges

Create(String)

Crée ou tronque et remplace un fichier dans le chemin spécifié.

Create(String, Int32)

Crée ou tronque et remplace un fichier dans le chemin spécifié, en spécifiant une taille de mémoire tampon.

Create(String, Int32, FileOptions)

Crée ou remplace un fichier dans l’accès spécifié, en indiquant une taille de mémoire tampon et des options qui décrivent comment créer ou remplacer le fichier.

Create(String, Int32, FileOptions, FileSecurity)

Crée ou remplace un fichier dans le chemin spécifié, en indiquant une taille de mémoire tampon, des options qui décrivent comment créer ou remplacer le fichier, ainsi qu’une valeur qui détermine la sécurité du contrôle d’accès et d’audit pour le fichier.

Create(String)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Crée ou tronque et remplace un fichier dans le chemin spécifié.

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

Paramètres

path
String

Chemin d'accès et nom du fichier à créer.

Retours

Élément FileStream qui fournit l'accès en lecture/écriture au fichier spécifié dans path.

Exceptions

L'appelant n'a pas l'autorisation requise.

- ou -

path a spécifié un fichier en lecture seule.

- ou -

path a spécifié un fichier qui est masqué.

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de la création du fichier.

path est dans un format non valide.

Exemples

L’exemple suivant crée un fichier dans le chemin spécifié, écrit des informations dans le fichier et lit à partir du fichier.

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

Remarques

L’objet FileStream créé par cette méthode a la valeur Nonepar défaut FileShare ; aucun autre processus ou code ne peut accéder au fichier créé tant que le handle de fichier d’origine n’est pas fermé.

Cette méthode équivaut à la surcharge de méthode Create(String, Int32) utilisant la taille de mémoire tampon par défaut de 4 096 octets.

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Si le fichier spécifié n’existe pas, il est créé ; s’il existe et qu’il n’est pas en lecture seule, le contenu est supprimé et remplacé.

Par défaut, l’accès en lecture/écriture complet aux nouveaux fichiers est accordé à tous les utilisateurs. Le fichier est ouvert avec un accès en lecture/écriture et doit être fermé avant de pouvoir être ouvert par une autre application.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

Create(String, Int32)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Crée ou tronque et remplace un fichier dans le chemin spécifié, en spécifiant une taille de mémoire tampon.

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

Paramètres

path
String

Chemin d'accès et nom du fichier à créer.

bufferSize
Int32

Nombre d'octets mis en mémoire tampon pour les opérations de lecture et d'écriture dans le fichier.

Retours

Élément FileStream avec la taille de la mémoire tampon spécifiée qui fournit l'accès en lecture/écriture au fichier spécifié dans path.

Exceptions

L'appelant n'a pas l'autorisation requise.

- ou -

path a spécifié un fichier en lecture seule.

- ou -

path a spécifié un fichier qui est masqué.

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de la création du fichier.

path est dans un format non valide.

Exemples

L’exemple suivant crée un fichier avec la taille de mémoire tampon spécifiée.

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

Remarques

L’objet FileStream créé par cette méthode a la valeur Nonepar défaut FileShare ; aucun autre processus ou code ne peut accéder au fichier créé tant que le handle de fichier d’origine n’est pas fermé.

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Cette méthode est équivalente à la surcharge du FileStream(String, FileMode, FileAccess, FileShare, Int32) constructeur. Si le fichier spécifié n’existe pas, il est créé ; s’il existe et qu’il n’est pas en lecture seule, le contenu est remplacé.

Par défaut, l’accès en lecture/écriture complet aux nouveaux fichiers est accordé à tous les utilisateurs. Le fichier est ouvert avec un accès en lecture/écriture et doit être fermé avant de pouvoir être ouvert par une autre application.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

Create(String, Int32, FileOptions)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Crée ou remplace un fichier dans l’accès spécifié, en indiquant une taille de mémoire tampon et des options qui décrivent comment créer ou remplacer le fichier.

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

Paramètres

path
String

Chemin d'accès et nom du fichier à créer.

bufferSize
Int32

Nombre d'octets mis en mémoire tampon pour les opérations de lecture et d'écriture dans le fichier.

options
FileOptions

Une des valeurs FileOptions qui décrit comment créer ou remplacer le fichier.

Retours

Nouveau fichier avec la taille de mémoire tampon spécifiée.

Exceptions

L'appelant n'a pas l'autorisation requise.

- ou -

path a spécifié un fichier en lecture seule.

- ou -

path a spécifié un fichier qui est masqué.

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de la création du fichier.

path est dans un format non valide.

Remarques

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Cette méthode est équivalente à la surcharge du FileStream(String, FileMode, FileAccess, FileShare, Int32) constructeur. Si le fichier spécifié n’existe pas, il est créé ; s’il existe et qu’il n’est pas en lecture seule, le contenu est remplacé.

Par défaut, l’accès en lecture/écriture complet aux nouveaux fichiers est accordé à tous les utilisateurs. Le fichier est ouvert avec un accès en lecture/écriture et doit être fermé avant de pouvoir être ouvert par une autre application.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

S’applique à

Create(String, Int32, FileOptions, FileSecurity)

Crée ou remplace un fichier dans le chemin spécifié, en indiquant une taille de mémoire tampon, des options qui décrivent comment créer ou remplacer le fichier, ainsi qu’une valeur qui détermine la sécurité du contrôle d’accès et d’audit pour le fichier.

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

Paramètres

path
String

Chemin d'accès et nom du fichier à créer.

bufferSize
Int32

Nombre d'octets mis en mémoire tampon pour les opérations de lecture et d'écriture dans le fichier.

options
FileOptions

Une des valeurs FileOptions qui décrit comment créer ou remplacer le fichier.

fileSecurity
FileSecurity

Objet FileSecurity qui détermine la sécurité de contrôle d’accès et d’audit du fichier.

Retours

Nouveau fichier avec la taille de mémoire tampon, les options du fichier et la sécurité du fichier spécifiées.

Exceptions

L'appelant n'a pas l'autorisation requise.

- ou -

path a spécifié un fichier en lecture seule.

- ou -

path a spécifié un fichier qui est masqué.

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de la création du fichier.

path est dans un format non valide.

Remarques

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Cette méthode est équivalente à la surcharge du FileStream(String, FileMode, FileAccess, FileShare, Int32) constructeur. Si le fichier spécifié n’existe pas, il est créé ; s’il existe et qu’il n’est pas en lecture seule, le contenu est remplacé.

Par défaut, l’accès en lecture/écriture complet aux nouveaux fichiers est accordé à tous les utilisateurs. Le fichier est ouvert avec un accès en lecture/écriture et doit être fermé avant de pouvoir être ouvert par une autre application.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Important

Cette méthode a été transférée vers .NET Core 3.1 sous la forme suivante : Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

S’applique à