Export (0) Print
Expand All

FileInfo::Open Method (FileMode, FileAccess)

Opens a file in the specified mode with read, write, or read/write access.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

public:
FileStream^ Open(
	FileMode mode, 
	FileAccess access
)

Parameters

mode
Type: System.IO::FileMode

A FileMode constant specifying the mode (for example, Open or Append) in which to open the file.

access
Type: System.IO::FileAccess

A FileAccess constant specifying whether to open the file with Read, Write, or ReadWrite file access.

Return Value

Type: System.IO::FileStream
A FileStream object opened in the specified mode and access, and unshared.

ExceptionCondition
SecurityException

The caller does not have the required permission.

FileNotFoundException

The file is not found.

UnauthorizedAccessException

path is read-only or is a directory.

DirectoryNotFoundException

The specified path is invalid, such as being on an unmapped drive.

IOException

The file is already open.

The following example opens a file as read-only and reads from the file.

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

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

   // Delete the file if it exists. 
   if (  !fi->Exists )
   {

      //Create the file.
      FileStream^ fs = fi->Create();
      try
      {
         array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );

         //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 = fi->Open( FileMode::Open, FileAccess::Read );
   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 ) );
      }
      try
      {
         //Try to write to the file.
         fs->Write( b, 0, b->Length );
      }
      catch ( Exception^ e ) 
      {
         Console::WriteLine( "Writing was disallowed, as expected: {0}", e );
      }
   }
   finally
   {
      if ( fs )
         delete (IDisposable^)fs;
   }
}
//This code produces output similar to the following;  
//results may vary based on the computer/file structure/etc.: 
// 
//This is some text in the file. 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
//Writing was disallowed, as expected: System.NotSupportedException: Stream does  
//not support writing. 
//   at System.IO.__Error.WriteNotSupported() 
//   at System.IO.FileStream.Write(Byte[] array, Int32 offset, Int32 count) 
//   at main() in c:\documents and settings\MyComputer\my documents\ 
//visual studio 2005\projects\finfo open2\finfo open2\ 
//cpp_console_application.cpp:line 46

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft