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.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStream(Windows::Storage::Streams::IRandomAccessStream ^ windowsRuntimeStream);

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

[<System.CLSCompliant(false)>]
static member AsStream : Windows.Storage.Streams.IRandomAccessStream -> System.IO.Stream

<Extension()>
Public Function AsStream (windowsRuntimeStream As IRandomAccessStream) As Stream

Параметры

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, используя указанный размер буфера.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStream(Windows::Storage::Streams::IRandomAccessStream ^ windowsRuntimeStream, int bufferSize);

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

[<System.CLSCompliant(false)>]
static member AsStream : Windows.Storage.Streams.IRandomAccessStream * int -> System.IO.Stream

<Extension()>
Public Function AsStream (windowsRuntimeStream As IRandomAccessStream, bufferSize As Integer) As Stream

Параметры

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 нулю, но это необходимо сделать только в том случае, если вы уверены, что отключение буферизации подходит для вашей ситуации.