IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Méthode

Définition

Espace de noms:

Windows.Storage

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

IAsyncOperation<IRandomAccessStream>

Une fois cette méthode terminée, elle retourne un IRandomAccessStream qui contient le flux d’accès aléatoire demandé.

Attributs

OverloadAttribute RemoteAsyncAttribute

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.