File.OpenWrite(String) Metodo

Definizione

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.

Si applica a

Vedi anche