FileInfo.Open Метод

Ссылка

Определение

Пространство имен:: System.IO

Сборки:: mscorlib.dll, System.IO.FileSystem.dll

Сборка:: System.IO.FileSystem.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Открывает файл с различными правами на чтение и запись и привилегиями для совместной работы.

Перегрузки

Open(FileMode)	Открывает файл в заданном режиме.
Open(FileStreamOptions)	Инициализирует новый экземпляр FileStream класса с указанным режимом создания, разрешением на чтение и запись и совместное использование, доступом других файловых потоков к тому же файлу, размером буфера, дополнительными параметрами файла и размером выделения.
Open(FileMode, FileAccess)	Открывает файл в заданном режиме с доступом для чтения или записи, или и для чтения, и для записи.
Open(FileMode, FileAccess, FileShare)	Открывает файл в заданном режиме с доступом для чтения, записи или и для чтения, и для записи и с заданным параметром совместного доступа.

Open(FileMode)

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Открывает файл в заданном режиме.

public:
 System::IO::FileStream ^ Open(System::IO::FileMode mode);

public System.IO.FileStream Open (System.IO.FileMode mode);

member this.Open : System.IO.FileMode -> System.IO.FileStream

Public Function Open (mode As FileMode) As FileStream

Параметры

mode: FileMode

Константа FileMode задает режим (например Open или Append), в котором необходимо открыть файл.

Возвращаемое значение

FileStream

Файл открыт в заданном режиме с доступом для чтения и записи и без предоставления общего доступа.

Исключения

FileNotFoundException

Файл не найден.

UnauthorizedAccessException

Файл доступен только для чтения или является каталогом.

DirectoryNotFoundException

Указан недопустимый путь (например, он ведет на несопоставленный диск).

IOException

Файл уже открыт.

Примеры

В следующем примере открывается файл, добавляется в файл некоторые сведения и считывается файл.

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 );
   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;
   }
}

//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.
//
//
//
//
//
//
//
//
//
//
//
//
//

using System;
using System.IO;
using System.Text;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\MyTest.txt";
        FileInfo fi = new FileInfo(path);

        // Delete the file if it exists.
        if (!fi.Exists)
        {
            //Create the file.
            using (FileStream fs = fi.Create())
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                //Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = fi.Open(FileMode.Open))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}
//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.
//
//
//
//
//
//
//
//
//
//
//
//

Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim fi As FileInfo = New FileInfo(path)
        Dim fs As FileStream

        ' Delete the file if it exists.
        If fi.Exists = False Then
            'Create the file.
            fs = fi.Create()
            Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")
            'Add some information to the file.
            fs.Write(info, 0, info.Length)
            fs.Close()
        End If

        'Open the stream and read it back.
        fs = fi.Open(FileMode.Open)
        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
        fs.Close()
    End Sub
End Class
'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.
'
'
'
'
'
'
'
'
'
'
'
'

См. также раздел

Применяется к

Open(FileStreamOptions)

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Инициализирует новый экземпляр FileStream класса с указанным режимом создания, разрешением на чтение и запись и совместное использование, доступом других файловых потоков к тому же файлу, размером буфера, дополнительными параметрами файла и размером выделения.

public:
 System::IO::FileStream ^ Open(System::IO::FileStreamOptions ^ options);

public System.IO.FileStream Open (System.IO.FileStreamOptions options);

member this.Open : System.IO.FileStreamOptions -> System.IO.FileStream

Public Function Open (options As FileStreamOptions) As FileStream

Параметры

options: FileStreamOptions

Объект , описывающий необязательные FileStream параметры для использования.

Возвращаемое значение

FileStream

Объект FileStream , который заключает открытый файл в оболочку.

Применяется к

Open(FileMode, FileAccess)

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Открывает файл в заданном режиме с доступом для чтения или записи, или и для чтения, и для записи.

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

public System.IO.FileStream Open (System.IO.FileMode mode, System.IO.FileAccess access);

member this.Open : System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream

Public Function Open (mode As FileMode, access As FileAccess) As FileStream

Параметры

mode: FileMode

Константа FileMode задает режим (например Open или Append), в котором необходимо открыть файл.

access: FileAccess

Константа FileAccess задает доступ к открываемому файлу: Read, Write или ReadWrite.

Возвращаемое значение

FileStream

Объект FileStream открыт в заданном режиме, с заданными правами и без предоставления общего доступа.

Исключения

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

FileNotFoundException

Файл не найден.

UnauthorizedAccessException

Name доступен только для чтения или является каталогом.

DirectoryNotFoundException

Указан недопустимый путь (например, он ведет на несопоставленный диск).

IOException

Файл уже открыт.

ArgumentException

Name является пустой строкой или содержит только пробелы.

ArgumentNullException

Один или несколько аргументов имеют значение NULL.

Примеры

В следующем примере открывается файл как доступный только для чтения и выполняется чтение из файла.

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

using System;
using System.IO;
using System.Text;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\MyTest.txt";
        FileInfo fi = new FileInfo(path);

        // Delete the file if it exists.
        if (!fi.Exists)
        {
            //Create the file.
            using (FileStream fs = fi.Create())
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                //Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = fi.Open(FileMode.Open, FileAccess.Read))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new 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.ToString());
            }
        }
    }
}
//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 Test.Main() in C:\Documents and Settings\My Computer\My Documents\
//Visual Studio 2005\Projects\finfo open2\finfo open2\Program.cs:line 39

imports System.IO
imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\MyTest.txt"
        Dim fi As FileInfo = new FileInfo(path)
        Dim fs As FileStream

        ' Delete the file if it exists.
        If fi.Exists = False
            'Create the file.
            fs = fi.Create()
            Dim info As Byte() = _
                    New UTF8Encoding(true).GetBytes( _
                        "This is some text in the file.")

            'Add some information to the file.
            fs.Write(info, 0, info.Length)
            fs.Close()
        End If

        'Open the stream and read it back.
        fs = fi.Open(FileMode.Open, FileAccess.Read)
        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
            Try
                fs.Write(b,0,b.Length)
                Catch e As Exception
                Console.WriteLine("Writing was disallowed, as expected: {0}", e.ToString())
            End Try
        fs.Close()
    End Sub
End Class
'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 VB_Console_Application.Test.Main() in C:\Documents and Settings\MyComputer
'\My Documents\Visual Studio 2005\Projects\finfo open2\finfo open2\Module1.vb:line 34
'

См. также раздел

Применяется к

Open(FileMode, FileAccess, FileShare)

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Исходный код:: FileInfo.cs

Открывает файл в заданном режиме с доступом для чтения, записи или и для чтения, и для записи и с заданным параметром совместного доступа.

public:
 System::IO::FileStream ^ Open(System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public System.IO.FileStream Open (System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

member this.Open : System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream

Public Function Open (mode As FileMode, access As FileAccess, share As FileShare) As FileStream

Параметры

mode: FileMode

Константа FileMode задает режим (например Open или Append), в котором необходимо открыть файл.

access: FileAccess

Константа FileAccess задает доступ к открываемому файлу: Read, Write или ReadWrite.

share: FileShare

Константа FileShare задает тип доступа к файлу для других объектов FileStream.

Возвращаемое значение

FileStream

Объект FileStream открыт в заданном режиме, с заданными правами и параметром общего доступа.

Исключения

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

FileNotFoundException

Файл не найден.

UnauthorizedAccessException

Name доступен только для чтения или является каталогом.

DirectoryNotFoundException

Указан недопустимый путь (например, он ведет на несопоставленный диск).

IOException

Файл уже открыт.

ArgumentException

Name является пустой строкой или содержит только пробелы.

ArgumentNullException

Один или несколько аргументов имеют значение NULL.

Примеры

В следующем примере показано открытие файла для чтения и записи, но запрет доступа к другим пользователям или процессам.

using namespace System;
using namespace System::IO;
int main()
{
   
   // Open an existing file, or create a new one.
   FileInfo^ fi = gcnew FileInfo( "temp.txt" );
   
   // Open the file just specified such that no one else can use it.
   FileStream^ fs = fi->Open( FileMode::OpenOrCreate, FileAccess::ReadWrite, FileShare::None );
   
   // Create another reference to the same file.
   FileInfo^ nextfi = gcnew FileInfo( "temp.txt" );
   try
   {
      
      // Try opening the same file, which was locked by the previous process.
      nextfi->Open( FileMode::OpenOrCreate, FileAccess::Read );
      Console::WriteLine( "The file was not locked, and was opened by a second process." );
   }
   catch ( IOException^ ) 
   {
      Console::WriteLine( "The file could not be opened because it was locked by another process." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e );
   }

   
   // Close the file so it can be deleted.
   fs->Close();
}
//This code produces output similar to the following; 
//results may vary based on the computer/file structure/etc.:
//
//The file could not be opened because it was locked by another process.

using System;
using System.IO;

public class OpenTest
{
    public static void Main()
    {
        // Open an existing file, or create a new one.
        FileInfo fi = new FileInfo("temp.txt");

        // Open the file just specified such that no one else can use it.
        FileStream fs = fi.Open( FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None );

        // Create another reference to the same file.
        FileInfo nextfi = new FileInfo("temp.txt");

        try
        {
            // Try opening the same file, which was locked by the previous process.
            nextfi.Open( FileMode.OpenOrCreate, FileAccess.Read );

            Console.WriteLine("The file was not locked, and was opened by a second process.");
        }
        catch (IOException)
        {
            Console.WriteLine("The file could not be opened because it was locked by another process.");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.ToString());
        }

        // Close the file so it can be deleted.
        fs.Close();
    }
}

//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//The file could not be opened because it was locked by another process.

Imports System.IO

Public Class OpenTest

    Public Shared Sub Main()
        ' Open an existing file, or create a new one.
        Dim fi As New FileInfo("temp.txt")

        ' Open the file just specified such that no one else can use it.
        Dim fs As FileStream = fi.Open(FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None)

        ' Create another reference to the same file.
        Dim nextfi As New FileInfo("temp.txt")

        Try
            ' Try opening the same file, which was locked by the previous process.
            nextfi.Open(FileMode.OpenOrCreate, FileAccess.Read)
            Console.WriteLine("The file was not locked, and was opened by a second process.")
        Catch i as IOException
            Console.WriteLine(i.ToString())
        Catch e As Exception
            Console.WriteLine(e.ToString())
        End Try

        ' Close the file so it can be deleted.
        fs.Close()
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'System.IO.IOException: The process cannot access the file 
''C:\Documents and Settings\mydirectory\My Documents\Visual Studio 2005
'\Projects\fileinfoopen\fileinfoopen\obj\Release\temp.txt' 
'because it is being used by another process.
'at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
'at System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, 
'Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions
'options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy)
'at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access,
'FileShare share) at System.IO.FileInfo.Open(FileMode mode, FileAccess access)
'at VB_Console_Application.OpenTest.Main() in C:\Documents and Settings
'\mydirectory\My Documents\Visual Studio 2005\Projects\VB_Console_Application
'\VB_Console_Application\Module1.vb:line 19

См. также раздел

Применяется к

Поделиться через

FileInfo.Open Метод

Определение

Перегрузки

Open(FileMode)

Параметры

Возвращаемое значение

Исключения

Примеры

См. также раздел

Применяется к

Open(FileStreamOptions)

Параметры

Возвращаемое значение

Комментарии

Применяется к

Open(FileMode, FileAccess)

Параметры

Возвращаемое значение

Исключения

Примеры

См. также раздел

Применяется к

Open(FileMode, FileAccess, FileShare)

Параметры

Возвращаемое значение

Исключения

Примеры

См. также раздел

Применяется к

Дополнительные ресурсы