File.OpenWrite(String) File.OpenWrite(String) File.OpenWrite(String) File.OpenWrite(String) Method

Definición

Abre un archivo existente o crea un nuevo archivo para escribir en él.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

Parámetros

path
String String String String

Archivo que se va a abrir para escritura.The file to be opened for writing.

Devoluciones

Objeto FileStream no compartido en la ruta de acceso especificada con acceso Write.An unshared FileStream object on the specified path with Write access.

Excepciones

El llamador no dispone del permiso requerido.The caller does not have the required permission.

O bien-or- path especifica un archivo de solo lectura o un directorio.path specified a read-only file or directory.

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid, (for example, it is on an unmapped drive).

path está en un formato no válido.path is in an invalid format.

Ejemplos

En el ejemplo siguiente se abre un archivo para lectura y escritura.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
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(1024) 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

Comentarios

Este método es equivalente a la FileStream(String, FileMode, FileAccess, FileShare) sobrecarga del constructor con el modo de OpenOrCreatearchivo establecido en, el Writeacceso establecido en y el modo de Noneuso compartido establecido en.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.

El OpenWrite método abre un archivo si ya existe uno para la ruta de acceso del archivo o crea un nuevo archivo si no existe 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. Para un archivo existente, no anexa el nuevo texto al texto existente.For an existing file, it does not append the new text to the existing text. En su lugar, sobrescribe los caracteres existentes con los caracteres nuevos.Instead, it overwrites the existing characters with the new characters. Si sobrescribe una cadena más larga (como "Esto es una prueba del método OpenWrite") con una cadena más corta (por ejemplo, "Second Run"), el archivo contendrá una combinación de las cadenas ("Second runtest del método 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").

El path parámetro puede especificar información relativa o absoluta de la ruta de acceso.The path parameter may specify relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, use GetCurrentDirectory el método.To obtain the current working directory, use the GetCurrentDirectory method.

El devuelto FileStream no admite la lectura.The returned FileStream does not support reading. Para abrir un archivo para lectura y escritura, use Open.To open a file for both reading and writing, use Open.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para escribir en el archivo especificado.for writing to the specified file. Enumeración asociada:WriteAssociated enumeration: Write

Se aplica a

Consulte también: