IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Метод

  • Ссылка

Определение

Пространство имен:
Windows.Storage
Изменить

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

public:
 IAsyncOperation<IRandomAccessStream ^> ^ OpenAsync(FileAccessMode accessMode, StorageOpenOptions options);
/// [Windows.Foundation.Metadata.Overload("OpenWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IRandomAccessStream> OpenAsync(FileAccessMode const& accessMode, StorageOpenOptions const& options);
[Windows.Foundation.Metadata.Overload("OpenWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IRandomAccessStream> OpenAsync(FileAccessMode accessMode, StorageOpenOptions options);
function openAsync(accessMode, options)
Public Function OpenAsync (accessMode As FileAccessMode, options As StorageOpenOptions) As IAsyncOperation(Of IRandomAccessStream)

Параметры

accessMode
FileAccessMode

Одно из значений перечисления, указывающее тип разрешенного доступа.

options
StorageOpenOptions

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

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

IAsyncOperation<IRandomAccessStream>

После завершения этого метода он возвращает IRandomAccessStream , содержащий запрошенный поток произвольного доступа.

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Комментарии

Если вы просто хотите открыть файл в приложении, см. метод OpenAsync класса StorageFile .

С помощью этого метода к файлу могут одновременно обращаться как средства чтения файлов, так и записи. Ниже приведена таблица, описывающая ситуации для различных параметров FileAccessMode и StorageOpenOptions.

FileAccessMode
StorageOpenOptions Read ReadWrite
Нет Читатель, имеющий более низкий приоритет, чем модуль записи. Если выполняется запись, это средство чтения с низким приоритетом завершится ошибкой. Это один модуль записи. Невозможно открыть файл, если используется OpenAsync(Read, AllowOnlyReaders), и это не позволит использовать новый OpenAsync(Read, AllowOnlyReaders).
AllowOnlyReaders Средство чтения, которое может существовать только с другими средствами чтения. Если попытка открыть с помощью модуля записи, произойдет сбой. Это один модуль записи. Невозможно открыть файл, если используется OpenAsync(Read, AllowOnlyReaders), и это не позволит использовать новый OpenAsync(Read, AllowOnlyReaders).
AllowReadersAndWriters Читатель, который может существовать одновременно с другими читателями и авторами. Этот модуль записи будет недействительным при записи с низким приоритетом и может сосуществовать с другими читателями и авторами.

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