WindowsRuntimeStreamExtensions.AsStream Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.WindowsRuntime.dll

Przeciążenia

AsStream(IRandomAccessStream)	Konwertuje strumień dostępu losowego w środowisko wykonawcze systemu Windows na strumień zarządzany na platformie .NET dla aplikacji ze Sklepu Windows.
AsStream(IRandomAccessStream, Int32)	Konwertuje strumień dostępu losowego w środowisko wykonawcze systemu Windows na strumień zarządzany na platformie .NET dla aplikacji ze Sklepu Windows przy użyciu określonego rozmiaru buforu.

AsStream(IRandomAccessStream)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Konwertuje strumień dostępu losowego w środowisko wykonawcze systemu Windows na strumień zarządzany na platformie .NET dla aplikacji ze Sklepu 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

Parametry

windowsRuntimeStream

IRandomAccessStream

Obiekt środowisko wykonawcze systemu Windows IRandomAccessStream do konwersji.

Zwraca

Stream

Przekonwertowany strumień.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

windowsRuntimeStream to null.

Uwagi

Uwaga

W języku Visual Basic i C# można wywołać tę metodę jako metodę wystąpienia dla dowolnego obiektu typu Stream. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).

Podczas konwertowania strumienia jest używany domyślny rozmiar buforu 16 384 bajtów. Aby określić inny rozmiar buforu, użyj przeciążenia AsStream(IRandomAccessStream, Int32) .

AsStream(IRandomAccessStream, Int32)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Konwertuje strumień dostępu losowego w środowisko wykonawcze systemu Windows na strumień zarządzany na platformie .NET dla aplikacji ze Sklepu Windows przy użyciu określonego rozmiaru buforu.

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

Parametry

windowsRuntimeStream

IRandomAccessStream

Obiekt środowisko wykonawcze systemu Windows IRandomAccessStream do konwersji.

bufferSize

Int32

Rozmiar buforu w bajtach. Ta wartość nie może być ujemna, ale może być równa 0 (zero), aby wyłączyć buforowanie.

Zwraca

Stream

Przekonwertowany strumień.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

windowsRuntimeStream to null.

ArgumentOutOfRangeException

bufferSize jest ujemna.

Uwagi

Uwaga

W języku Visual Basic i C# można wywołać tę metodę jako metodę wystąpienia dla dowolnego obiektu typu Stream. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).

Ta metoda służy do określania rozmiaru buforu podczas konwertowania strumienia. Aby użyć domyślnego rozmiaru buforu 16 384 bajtów, użyj AsStream(IRandomAccessStream) przeciążenia.

W większości sytuacji buforowanie poprawia wydajność operacji strumienia. Buforowanie można wyłączyć, ustawiając bufferSize wartość zero, ale należy to zrobić tylko wtedy, gdy masz pewność, że wyłączenie buforowania jest odpowiednie dla danej sytuacji.