IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Cuando se completa este método, devuelve un IRandomAccessStream que contiene la secuencia de acceso aleatorio solicitada.
- Atributos
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. |