IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Método

Definición

Espacio de nombres:

Windows.Storage

Abre una secuencia de acceso aleatorio sobre el archivo.

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

Uno de los valores de enumeración que especifica el tipo de acceso que se va a permitir.

options

StorageOpenOptions

Combinación bit a bit de los valores de enumeración que especifican opciones para abrir la secuencia.

Devoluciones

IAsyncOperation<IRandomAccessStream>

Cuando se completa este método, devuelve un IRandomAccessStream que contiene la secuencia de acceso aleatorio solicitada.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Si simplemente desea abrir un archivo en la aplicación, consulte el método OpenAsync de la clase StorageFile .

Con este método, los lectores de archivos y los escritores pueden acceder simultáneamente a un archivo. A continuación se muestra una tabla que describe las situaciones de varias configuraciones de parámetros de FileAccessMode y StorageOpenOptions:

	FileAccessMode
StorageOpenOptions	Leer	ReadWrite
None	Lector que es de menor prioridad que un escritor. Si se produce una escritura, se producirá un error en este lector de prioridad baja.	Se trata de un único escritor. No se puede abrir el archivo si se ha usado OpenAsync(Read, AllowOnlyReaders) y impedirá que se use un nuevo OpenAsync(Read, AllowOnlyReaders).
AllowOnlyReaders	Lector que solo puede existir con otros lectores. Si se intenta abrir con un escritor, se producirá un error.	Se trata de un único escritor. No se puede abrir el archivo si se ha usado OpenAsync(Read, AllowOnlyReaders) y impedirá que se use un nuevo OpenAsync(Read, AllowOnlyReaders).
AllowReadersAndWriters	Lector que puede existir con otros lectores y escritores simultáneamente.	Este escritor invalidará a los lectores de prioridad baja cuando se produzca una escritura y pueda coexistir con otros lectores y escritores.