IRandomAccessStreamReference Интерфейс

Ссылка

Определение

Пространство имен:: Windows.Storage.Streams

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Позволяет компоненту среда выполнения Windows предоставлять доступ к инкапсулированному потоку.

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 IRandomAccessStreamReference

Public Interface IRandomAccessStreamReference

Производный: Windows.Services.TargetedContent.TargetedContentFile

Windows.Services.TargetedContent.TargetedContentImage

Windows.Storage.BulkAccess.FileInformation

Windows.Storage.IStorageFile

Windows.Storage.StorageFile

Подробнее…

Атрибуты: ContractVersionAttribute GuidAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Реализуйте интерфейс IRandomAccessStreamReference, когда компонент среда выполнения Windows предоставляет вызывающим абонентам поток произвольного доступа. Для последовательного потока, доступного только для чтения, реализуйте интерфейс IInputStreamReference .

Например, StorageFile предоставляет IRandomAccessStream для содержимого файла, поэтому он реализует интерфейс IRandomAccessStreamReference. Обычно для предоставления потока требуется доступ к жесткому диску, поэтому потоковые операции являются асинхронными. Компоненты, использующие содержимое файла, получают IRandomAccessStreamReference вместо ссылки StorageFile , так как этот интерфейс является более минимальным требованием для входного параметра.

Важно!

Не все источники могут эффективно предоставлять потоки произвольного доступа. Если компоненту требуется только последовательный доступ на чтение, рассмотрите возможность реализации интерфейса IInputStreamReference вместо интерфейса IRandomAccessStreamReference.

Методы

OpenReadAsync()

Открывает поток для произвольного доступа.

Применяется к

См. также раздел

IInputStreamReference