WindowsRuntimeStreamExtensions.AsStream Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.WindowsRuntime.dll

Перегрузки

AsStream(IRandomAccessStream)	Преобразует поток случайного доступа в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows.
AsStream(IRandomAccessStream, Int32)	Преобразует поток случайного доступа в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows, используя указанный размер буфера.

AsStream(IRandomAccessStream)

Важно!

Этот API несовместим с CLS.

Преобразует поток случайного доступа в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows.

C#

[System.CLSCompliant(false)]
public static System.IO.Stream AsStream (this Windows.Storage.Streams.IRandomAccessStream windowsRuntimeStream);

Параметры

windowsRuntimeStream

IRandomAccessStream

Объект среды выполнения Windows IRandomAccessStream для преобразования.

Возвращаемое значение

Stream

Преобразованный поток.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

windowsRuntimeStream null.

Комментарии

Примечание

В Visual Basic и C#этот метод можно вызвать как метод экземпляра для любого объекта типа Stream. При использовании синтаксиса метода экземпляра для вызова этого метода опустите первый параметр. Дополнительные сведения см. в методах расширения (Visual Basic) или методах расширения (руководство по программированию на C#).

Размер буфера по умолчанию составляет 16 384 байта при преобразовании потока. Чтобы указать другой размер буфера, используйте перегрузку AsStream(IRandomAccessStream, Int32).

AsStream(IRandomAccessStream, Int32)

Важно!

Этот API несовместим с CLS.

Преобразует поток случайного доступа в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows, используя указанный размер буфера.

C#

[System.CLSCompliant(false)]
public static System.IO.Stream AsStream (this Windows.Storage.Streams.IRandomAccessStream windowsRuntimeStream, int bufferSize);

Параметры

windowsRuntimeStream

IRandomAccessStream

Объект среды выполнения Windows IRandomAccessStream для преобразования.

bufferSize

Int32

Размер буфера в байтах. Это значение не может быть отрицательным, но может иметь значение 0 (ноль), чтобы отключить буферизацию.

Возвращаемое значение

Stream

Преобразованный поток.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

windowsRuntimeStream null.

ArgumentOutOfRangeException

bufferSize отрицательно.

Комментарии

Примечание

В Visual Basic и C#этот метод можно вызвать как метод экземпляра для любого объекта типа Stream. При использовании синтаксиса метода экземпляра для вызова этого метода опустите первый параметр. Дополнительные сведения см. в методах расширения (Visual Basic) или методах расширения (руководство по программированию на C#).

Этот метод используется для указания размера буфера при преобразовании потока. Чтобы использовать размер буфера по умолчанию размером 16 384 байт, используйте перегрузку AsStream(IRandomAccessStream).

В большинстве случаев буферизация повышает производительность операций потока. Буферизацию можно отключить, задав bufferSize нулю, но это необходимо сделать только в том случае, если вы уверены, что отключение буферизации подходит для вашей ситуации.