IRandomAccessStreamReference Interface
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.
Permet à un composant Windows Runtime de fournir l’accès à un flux encapsulé.
public interface class IRandomAccessStreamReference/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
struct IRandomAccessStreamReference[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
public interface IRandomAccessStreamReferencePublic Interface IRandomAccessStreamReference- Dérivé
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Remarques
Implémentez l’interface IRandomAccessStreamReference lorsque votre composant Windows Runtime expose un flux d’accès aléatoire aux appelants. Pour un flux séquentiel en lecture seule, implémentez l’interface IInputStreamReference .
Par exemple, un StorageFile fournit un IRandomAccessStream pour le contenu d’un fichier, de sorte qu’il implémente l’interface IRandomAccessStreamReference. En règle générale, la fourniture d’un flux nécessite l’accès au disque dur. Les opérations de flux sont donc asynchrones. Les composants qui utilisent le contenu du fichier reçoivent une référence IRandomAccessStreamReference au lieu d’une référence StorageFile , car cette interface est la configuration minimale requise pour le paramètre d’entrée.
Important
Toutes les sources ne peuvent pas fournir efficacement des flux d’accès aléatoire. Si un composant nécessite uniquement un accès en lecture séquentiel, envisagez d’implémenter l’interface IInputStreamReference au lieu de l’interface IRandomAccessStreamReference.
Méthodes
| OpenReadAsync() |
Ouvre un flux pour un accès aléatoire. |