File.OpenWrite(String) Metodo

Definizione

Apre un file esistente o crea un nuovo file per la scrittura.Opens an existing file or creates a new file for writing.

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.The file to be opened for writing.

Restituisce

Oggetto FileStream non condiviso nel percorso specificato con accesso a Write.An unshared FileStream object on the specified path with Write access.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

-oppure--or- path ha specificato un file o una directory di sola lettura.path specified a read-only file or directory.

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path è null.path is null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid, (for example, it is on an unmapped drive).

Il formato di path non è valido.path is in an invalid format.

Esempi

Nell'esempio seguente viene aperto un file per la lettura e la scrittura.The following example opens a file for reading and writing.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";

   // Open the stream and write to it.
   {
      FileStream^ fs = File::OpenWrite( path );
      try
      {
         array<Byte>^info = (gcnew UTF8Encoding( true ))->
            GetBytes( "This is to test the OpenWrite method." );

         // 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.
   {
      FileStream^ fs = File::OpenRead( path );
      try
      {
         array<Byte>^b = gcnew array<Byte>(1024);
         UTF8Encoding^ temp = gcnew UTF8Encoding( true );
         while ( fs->Read( b, 0, b->Length ) > 0 )
         {
            Console::WriteLine( temp->GetString( b ) );
         }
      }
      finally
      {
         if ( fs )
            delete(IDisposable^)fs;
      }
   }
}
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));
            }
        }
    }
}
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 costruttore FileStream(String, FileMode, FileAccess, FileShare) con la modalità file impostata su OpenOrCreate, l'accesso impostato su Writee la modalità di condivisione impostata su None.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare) constructor overload with file mode set to OpenOrCreate, the access set to Write, and the share mode set to None.

Il metodo OpenWrite apre un file se ne esiste già uno per il percorso del file oppure crea un nuovo file se non ne esiste uno.The OpenWrite method opens a file if one already exists for the file path, or creates a new file if one does not exist. Per un file esistente, non aggiunge il nuovo testo al testo esistente.For an existing file, it does not append the new text to the existing text. Al contrario, sovrascrive i caratteri esistenti con i nuovi caratteri.Instead, it overwrites the existing characters with the new characters. Se si sovrascrive una stringa più lunga (ad esempio "questo è un test del metodo OpenWrite") con una stringa più breve (ad esempio "seconda esecuzione"), il file conterrà una combinazione delle stringhe ("secondo runTest del metodo OpenWrite").If you overwrite a longer string (such as "This is a test of the OpenWrite method") with a shorter string (such as "Second run"), the file will contain a mix of the strings ("Second runtest of the OpenWrite method").

Il parametro path può specificare informazioni sul percorso relativo o assoluto.The path parameter may specify relative or absolute path information. Le informazioni sul percorso relativo vengono interpretate in relazione alla directory di lavoro corrente.Relative path information is interpreted as relative to the current working directory. Per ottenere la directory di lavoro corrente, usare il metodo GetCurrentDirectory.To obtain the current working directory, use the GetCurrentDirectory method.

Il FileStream restituito non supporta la lettura.The returned FileStream does not support reading. Per aprire un file per la lettura e la scrittura, utilizzare Open.To open a file for both reading and writing, use Open.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Sicurezza

FileIOPermission
per la scrittura nel file specificato.for writing to the specified file. Enumerazione associata: WriteAssociated enumeration: Write

Si applica a

Vedi anche