Partage via


IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Méthode

Définition

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.

S’applique à