FileInfo.Open Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает файл с различными привилегиями чтения и записи и общего доступа.
Перегрузки
| Имя | Описание |
|---|---|
| Open(FileMode) |
Открывает файл в указанном режиме. |
| Open(FileStreamOptions) |
Инициализирует новый экземпляр FileStream класса с указанным режимом создания, разрешением на чтение и запись и общий доступ, доступ к другим файлам может иметь тот же файл, размер буфера, дополнительные параметры файла и размер выделения. |
| Open(FileMode, FileAccess) |
Открывает файл в указанном режиме с доступом на чтение, запись или запись. |
| Open(FileMode, FileAccess, FileShare) |
Открывает файл в указанном режиме с доступом на чтение, запись или запись и указанный параметр общего доступа. |
Open(FileMode)
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
- Исходный код:
- 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) для открытия файла.
Возвращаемое значение
Файл, открытый в указанном режиме, с доступом на чтение и запись и без общего доступа.
Исключения
Файл не найден.
Файл доступен только для чтения или является каталогом.
Указанный путь недопустим, например на несопоставленном диске.
Файл уже открыт.
Примеры
В следующем примере открывается файл, добавляется некоторая информация в файл и считывается файл.
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
- Исходный код:
- 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(String, FileStreamOptions) сведения об исключениях.
Применяется к
Open(FileMode, FileAccess)
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
- Исходный код:
- 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помощью или WriteReadWrite доступа к файлам.
Возвращаемое значение
FileStream Объект, открытый в указанном режиме и доступе, и не общий доступ.
Исключения
Вызывающий объект не имеет требуемого разрешения.
Файл не найден.
Name доступен только для чтения или является каталогом.
Указанный путь недопустим, например на несопоставленном диске.
Файл уже открыт.
Name является пустым или содержит только пробелы.
Один или несколько аргументов имеет значение NULL.
Примеры
В следующем примере файл открывается как доступный только для чтения и считывается из файла.
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
- Исходный код:
- 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помощью или WriteReadWrite доступа к файлам.
- share
- FileShare
Константы FileShare , указывающие тип доступа к другим FileStream объектам, должны иметь этот файл.
Возвращаемое значение
FileStream Объект, открытый с указанным режимом, доступом и параметрами общего доступа.
Исключения
Вызывающий объект не имеет требуемого разрешения.
Файл не найден.
Name доступен только для чтения или является каталогом.
Указанный путь недопустим, например на несопоставленном диске.
Файл уже открыт.
Name является пустым или содержит только пробелы.
Один или несколько аргументов имеет значение NULL.
Примеры
В следующем примере показано открытие файла для чтения и записи, но запрет доступа к другим пользователям или процессам.
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
См. также раздел
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл