IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает поток произвольного доступа к файлу.
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
Побитовое сочетание значений перечисления, указывающее параметры для открытия потока.
Возвращаемое значение
После завершения этого метода он возвращает IRandomAccessStream , содержащий запрошенный поток произвольного доступа.
- Атрибуты
Комментарии
Если вы просто хотите открыть файл в приложении, см. метод OpenAsync класса StorageFile .
С помощью этого метода к файлу могут одновременно обращаться как средства чтения файлов, так и записи. Ниже приведена таблица, описывающая ситуации для различных параметров FileAccessMode и StorageOpenOptions.
FileAccessMode | ||
---|---|---|
StorageOpenOptions | Read | ReadWrite |
Нет | Читатель, имеющий более низкий приоритет, чем модуль записи. Если выполняется запись, это средство чтения с низким приоритетом завершится ошибкой. | Это один модуль записи. Невозможно открыть файл, если используется OpenAsync(Read, AllowOnlyReaders), и это не позволит использовать новый OpenAsync(Read, AllowOnlyReaders). |
AllowOnlyReaders | Средство чтения, которое может существовать только с другими средствами чтения. Если попытка открыть с помощью модуля записи, произойдет сбой. | Это один модуль записи. Невозможно открыть файл, если используется OpenAsync(Read, AllowOnlyReaders), и это не позволит использовать новый OpenAsync(Read, AllowOnlyReaders). |
AllowReadersAndWriters | Читатель, который может существовать одновременно с другими читателями и авторами. | Этот модуль записи будет недействительным при записи с низким приоритетом и может сосуществовать с другими читателями и авторами. |