IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Método

Definição

Namespace:

Windows.Storage

Abre um fluxo de acesso aleatório sobre o arquivo.

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)

Parâmetros

accessMode

FileAccessMode

Um dos valores de enumeração que especifica o tipo de acesso a ser permitido.

options

StorageOpenOptions

Uma combinação bit a bit dos valores de enumeração que especificam opções para abrir o fluxo.

Retornos

IAsyncOperation<IRandomAccessStream>

Quando esse método for concluído, ele retornará um IRandomAccessStream que contém o fluxo de acesso aleatório solicitado.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

Se você simplesmente quiser abrir um arquivo em seu aplicativo, consulte o método OpenAsync da classe StorageFile .

Usando esse método, um arquivo pode ser acessado por leitores de arquivo e gravadores simultaneamente. Veja a seguir uma tabela que descreve as situações para várias configurações de parâmetro de FileAccessMode e StorageOpenOptions:

	FileAccessMode
StorageOpenOptions	Ler	ReadWrite
Nenhum	Um leitor que tem prioridade mais baixa do que um gravador. Se ocorrer uma gravação, esse leitor de baixa prioridade falhará.	Este é um único escritor. O arquivo não poderá ser aberto se OpenAsync(Read, AllowOnlyReaders) tiver sido usado e impedirá que um novo OpenAsync(Read, AllowOnlyReaders) seja usado.
AllowOnlyReaders	Um leitor que só pode existir com outros leitores. Se uma tentativa de abertura for tentada com um gravador, ela falhará.	Este é um único escritor. O arquivo não poderá ser aberto se OpenAsync(Read, AllowOnlyReaders) tiver sido usado e impedirá que um novo OpenAsync(Read, AllowOnlyReaders) seja usado.
AllowReadersAndWriters	Um leitor que pode existir com outros leitores e escritores simultaneamente.	Esse gravador invalidará leitores de baixa prioridade quando ocorrer uma gravação e poderá coexistir com outros leitores e escritores.