IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ouvre un flux d’accès aléatoire sur le fichier.
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)
Paramètres
- accessMode
- FileAccessMode
Une des valeurs d’énumération qui spécifie le type d’accès à autoriser.
- options
- StorageOpenOptions
Combinaison de bits des valeurs d’énumération qui spécifient les options d’ouverture du flux.
Retours
Une fois cette méthode terminée, elle retourne un IRandomAccessStream qui contient le flux d’accès aléatoire demandé.
- Attributs
Remarques
Si vous souhaitez simplement ouvrir un fichier dans votre application, consultez la méthode OpenAsync de la classe StorageFile .
À l’aide de cette méthode, un fichier est accessible simultanément aux lecteurs de fichiers et aux rédacteurs. Voici un tableau décrivant les situations pour les différents paramètres de FileAccessMode et StorageOpenOptions :
FileAccessMode | ||
---|---|---|
StorageOpenOptions | Lire | Lecture/écriture |
None | Lecteur dont la priorité est inférieure à celle d’un writer. Si une écriture se produit, ce lecteur de faible priorité échoue. | Il s’agit d’un writer unique. Impossible d’ouvrir le fichier si OpenAsync(Read, AllowOnlyReaders) a été utilisé et qu’il empêchera l’utilisation d’un nouvel OpenAsync(Read, AllowOnlyReaders). |
AllowOnlyReaders | Lecteur qui ne peut exister qu’avec d’autres lecteurs. Si une tentative d’ouverture est effectuée avec un writer, elle échoue. | Il s’agit d’un writer unique. Impossible d’ouvrir le fichier si OpenAsync(Read, AllowOnlyReaders) a été utilisé et qu’il empêchera l’utilisation d’un nouvel OpenAsync(Read, AllowOnlyReaders). |
AllowReadersAndWriters | Lecteur qui peut exister avec d’autres lecteurs et rédacteurs simultanément. | Cet enregistreur invalidera les lecteurs de faible priorité lorsqu’une écriture se produit et peut coexister avec d’autres lecteurs et écrivains. |