File.OpenWrite(String) 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.
Ouvre un fichier existant ou crée un fichier pour l’écriture.
public:
static System::IO::FileStream ^ OpenWrite(System::String ^ path);
public static System.IO.FileStream OpenWrite(string path);
static member OpenWrite : string -> System.IO.FileStream
Public Shared Function OpenWrite (path As String) As FileStream
Paramètres
- path
- String
Fichier à ouvrir pour l’écriture.
Retours
Objet non partagé FileStream sur le chemin d’accès Write spécifié.
Exceptions
L’appelant n’a pas l’autorisation requise.
-ou-
path spécifié un fichier ou un répertoire en lecture seule.
.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é).
path est dans un format non valide.
Exemples
L’exemple suivant ouvre un fichier pour la lecture et l’écriture.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// Open the stream and write to it.
using (FileStream fs = File.OpenWrite(path))
{
Byte[] info =
new UTF8Encoding(true).GetBytes("This is to test the OpenWrite method.");
// Add some information to the file.
fs.Write(info, 0, info.Length);
}
// Open the stream and read it back.
using (FileStream fs = File.OpenRead(path))
{
byte[] b = new byte[1024];
UTF8Encoding temp = new UTF8Encoding(true);
while (fs.Read(b,0,b.Length) > 0)
{
Console.WriteLine(temp.GetString(b));
}
}
}
}
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// Open the stream and write to it.
do
use fs = File.OpenWrite path
let info =
UTF8Encoding(true)
.GetBytes "This is to test the OpenWrite method."
// Add some information to the file.
fs.Write(info, 0, info.Length)
// Open the stream and read it back.
do
use fs = File.OpenRead path
let b = Array.zeroCreate 1024
let temp = UTF8Encoding true
while fs.Read(b, 0, b.Length) > 0 do
printfn $"{temp.GetString b}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
' Open the stream and write to it.
Using fs As FileStream = File.OpenWrite(path)
Dim info As Byte() = _
New UTF8Encoding(True).GetBytes("This is to test the OpenWrite method.")
' Add some information to the file.
fs.Write(info, 0, info.Length)
End Using
'Open the stream and read it back.
Using fs As FileStream = File.OpenRead(path)
Dim b(1023) As Byte
Dim temp As UTF8Encoding = New UTF8Encoding(True)
Do While fs.Read(b, 0, b.Length) > 0
Console.WriteLine(temp.GetString(b))
Loop
End Using
End Sub
End Class
Remarques
Cette méthode équivaut à la surcharge du constructeur avec le FileStream(String, FileMode, FileAccess, FileShare) mode fichier défini OpenOrCreatesur , le jeu d’accès sur Writeet le mode de partage défini sur None.
La OpenWrite méthode ouvre un fichier s’il existe déjà pour le chemin d’accès au fichier, ou crée un fichier s’il n’en existe pas. Pour un fichier existant, il n’ajoute pas le nouveau texte au texte existant. Au lieu de cela, il remplace les caractères existants par les nouveaux caractères. Si vous remplacez une chaîne plus longue (par exemple, « Il s’agit d’un test de la méthode OpenWrite ») avec une chaîne plus courte (par exemple, « Deuxième exécution »), le fichier contient une combinaison des chaînes (« Second runtest of the OpenWrite method »).
Le path paramètre peut 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, utilisez la GetCurrentDirectory méthode.
Le retour FileStream ne prend pas en charge la lecture. Pour ouvrir un fichier à la fois pour la lecture et l’écriture, utilisez Open.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.