File.OpenWrite(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Apre un file esistente o crea un nuovo file per la scrittura.
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
Parametri
- path
- String
File da aprire per la scrittura.
Valori restituiti
Oggetto non condiviso FileStream nel percorso specificato con Write accesso.
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
oppure
path è stato specificato un file o una directory di sola lettura.
.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio in un'unità non mappata.
path è in un formato non valido.
Esempio
Nell'esempio seguente viene aperto un file per la lettura e la scrittura.
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
Commenti
Questo metodo equivale all'overload del FileStream(String, FileMode, FileAccess, FileShare) costruttore con la modalità file impostata su OpenOrCreate, l'accesso impostato su Writee la modalità di condivisione impostata su None.
Il OpenWrite metodo apre un file se ne esiste già uno per il percorso del file o crea un nuovo file se non ne esiste uno. Per un file esistente, non aggiunge il nuovo testo al testo esistente. Sovrascrive invece i caratteri esistenti con i nuovi caratteri. Se si sovrascrive una stringa più lunga ,ad esempio "This is a test of the OpenWrite method") with a short string (such as "Second run"), il file conterrà una combinazione di stringhe ("Second runtest del metodo OpenWrite").
Il path parametro può specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, utilizzare il GetCurrentDirectory metodo .
L'oggetto restituito FileStream non supporta la lettura. Per aprire un file sia per la lettura che per la scrittura, usare Open.
Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.