File.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée, ou tronque et remplace un fichier dans le chemin d’accès spécifié.
Surcharges
| Nom | Description |
|---|---|
| Create(String) |
Crée, ou tronque et remplace un fichier dans le chemin d’accès spécifié. |
| Create(String, Int32) |
Crée ou tronque et remplace un fichier dans le chemin d’accès spécifié, en spécifiant une taille de mémoire tampon. |
| Create(String, Int32, FileOptions) |
Crée ou remplace un fichier dans le chemin d’accès spécifié, en spécifiant 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 d’accès spécifié, en spécifiant une taille de mémoire tampon, des options qui décrivent comment créer ou remplacer le fichier et une valeur qui détermine le contrôle d’accès et la sécurité d’audit du fichier. |
Create(String)
Crée, ou tronque et remplace un fichier dans le chemin d’accès 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
Qui FileStream fournit un accès en lecture/écriture au fichier spécifié dans path.
Exceptions
L’appelant n’a pas l’autorisation requise.
-ou-
path spécifié un fichier en lecture seule.
-ou-
path spécifié un fichier masqué.
.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().
path a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il se trouve 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 d’accès spécifié, écrit des informations dans le fichier et lit à partir du fichier.
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 une 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 à l’aide Create(String, Int32) de 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 d’E/S courantes.
Voir aussi
- E/S de fichier et de flux
- lecture de texte à partir d’un fichier
- Guide pratique pour écrire du texte dans un fichier
- Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
S’applique à
Create(String, Int32)
Crée ou tronque et remplace un fichier dans le chemin d’accès 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 lectures et les écritures dans le fichier.
Retours
Avec FileStream la taille de mémoire tampon spécifiée qui fournit un accès en lecture/écriture au fichier spécifié dans path.
Exceptions
L’appelant n’a pas l’autorisation requise.
-ou-
path spécifié un fichier en lecture seule.
-ou-
path spécifié un fichier masqué.
.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().
path a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il se trouve 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 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 une 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 équivaut à 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 d’E/S courantes.
Voir aussi
- E/S de fichier et de flux
- lecture de texte à partir d’un fichier
- Guide pratique pour écrire du texte dans un fichier
- Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
S’applique à
Create(String, Int32, FileOptions)
Crée ou remplace un fichier dans le chemin d’accès spécifié, en spécifiant 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 lectures et les écritures dans le fichier.
- options
- FileOptions
Une des FileOptions valeurs qui explique 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 spécifié un fichier en lecture seule.
-ou-
path spécifié un fichier masqué.
.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().
path a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il se trouve 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 équivaut à 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 d’E/S courantes.
S’applique à
Create(String, Int32, FileOptions, FileSecurity)
Crée ou remplace un fichier dans le chemin d’accès spécifié, en spécifiant une taille de mémoire tampon, des options qui décrivent comment créer ou remplacer le fichier et une valeur qui détermine le contrôle d’accès et la sécurité d’audit du 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 lectures et les écritures dans le fichier.
- options
- FileOptions
Une des FileOptions valeurs qui explique comment créer ou remplacer le fichier.
- fileSecurity
- FileSecurity
Objet FileSecurity qui détermine le contrôle d’accès et la sécurité d’audit du fichier.
Retours
Nouveau fichier avec la taille de mémoire tampon, les options de fichier et la sécurité des fichiers spécifiées.
Exceptions
L’appelant n’a pas l’autorisation requise.
-ou-
path spécifié un fichier en lecture seule.
-ou-
path spécifié un fichier masqué.
.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().
path a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il se trouve 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 équivaut à 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 d’E/S courantes.
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).