IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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. |