Partilhar via


IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Método

Definição

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

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

Atributos

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.

Aplica-se a