File.Create Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

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)

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

FileStream

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

Exceptions

UnauthorizedAccessException

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é.

ArgumentException

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

ArgumentNullException

path a la valeur null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

• Fichier et flux de données E/S
• Lecture de texte à partir d’un fichier
• Procédure : écrire du texte dans un fichier
• Procédure : lire et écrire dans un fichier de données créé récemment

Create(String, Int32)

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

FileStream

É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

UnauthorizedAccessException

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é.

ArgumentException

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

ArgumentNullException

path a la valeur null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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

• Fichier et flux de données E/S
• Lecture de texte à partir d’un fichier
• Procédure : écrire du texte dans un fichier
• Procédure : lire et écrire dans un fichier de données créé récemment

Create(String, Int32, FileOptions)

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

FileStream

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

Exceptions

UnauthorizedAccessException

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é.

ArgumentException

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

ArgumentNullException

path a la valeur null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

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.