WindowsRuntimeStreamExtensions.AsStream Methode

Definition

Überlädt

AsStream(IRandomAccessStream)

Konvertiert einen Random-Access-Stream in der Windows-Runtime in einen verwalteten Stream in .NET für Microsoft Store-Apps.Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.

AsStream(IRandomAccessStream, Int32)

Konvertiert einen Random-Access-Stream in der Windows-Runtime mithilfe der angegebenen Puffergröße in einen verwalteten Stream in .NET für Microsoft Store-Apps.Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.

AsStream(IRandomAccessStream)

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert einen Random-Access-Stream in der Windows-Runtime in einen verwalteten Stream in .NET für Microsoft Store-Apps.Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.

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);
static member AsStream : Windows.Storage.Streams.IRandomAccessStream -> System.IO.Stream
<Extension()>
Public Function AsStream (windowsRuntimeStream As IRandomAccessStream) As Stream

Parameter

windowsRuntimeStream
IRandomAccessStream

Das Windows-Runtime-IRandomAccessStream-Objekt, das konvertiert werden soll.The Windows Runtime IRandomAccessStream object to convert.

Gibt zurück

Die konvertierte Stream.The converted stream.

Attribute

Ausnahmen

windowsRuntimeStream ist null.windowsRuntimeStream is null.

Hinweise

Hinweis

In Visual Basic und C#können Sie diese Methode als Instanzmethode für ein beliebiges Objekt vom Typ Streamabrufen.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus.When you use instance method syntax to call this method, omit the first parameter. Weitere Informationen finden Sie unter Erweiterungs Methoden (Visual Basic) oder Erweiterungs Methoden (C# Programmier Handbuch).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Beim wandeln des Streams wird eine Standardpuffergröße von 16.384 Bytes verwendet.A default buffer size of 16,384 bytes is used when converting the stream. Verwenden Sie die AsStream(IRandomAccessStream, Int32) Überladung, um eine andere Puffergröße anzugeben.To specify a different buffer size, use the AsStream(IRandomAccessStream, Int32) overload.

AsStream(IRandomAccessStream, Int32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert einen Random-Access-Stream in der Windows-Runtime mithilfe der angegebenen Puffergröße in einen verwalteten Stream in .NET für Microsoft Store-Apps.Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.

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);
static member AsStream : Windows.Storage.Streams.IRandomAccessStream * int -> System.IO.Stream
<Extension()>
Public Function AsStream (windowsRuntimeStream As IRandomAccessStream, bufferSize As Integer) As Stream

Parameter

windowsRuntimeStream
IRandomAccessStream

Das Windows-Runtime-IRandomAccessStream-Objekt, das konvertiert werden soll.The Windows Runtime IRandomAccessStream object to convert.

bufferSize
Int32

Die Größe des Cookies in Bytes.The size, in bytes, of the buffer. Dieser Wert kann nicht negativ sein, aber er kann 0 (null) sein, um die Pufferung zu deaktivieren.This value cannot be negative, but it can be 0 (zero) to disable buffering.

Gibt zurück

Die konvertierte Stream.The converted stream.

Attribute

Ausnahmen

windowsRuntimeStream ist null.windowsRuntimeStream is null.

bufferSize ist ein negativer Wert.bufferSize is negative.

Hinweise

Hinweis

In Visual Basic und C#können Sie diese Methode als Instanzmethode für ein beliebiges Objekt vom Typ Streamabrufen.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus.When you use instance method syntax to call this method, omit the first parameter. Weitere Informationen finden Sie unter Erweiterungs Methoden (Visual Basic) oder Erweiterungs Methoden (C# Programmier Handbuch).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Sie verwenden diese Methode, um eine Puffergröße anzugeben, wenn der Stream umgerechnet wird.You use this method to specify a buffer size when converting the stream. Um die Standardpuffergröße von 16.384 Bytes zu verwenden, verwenden Sie die AsStream(IRandomAccessStream) Überladung.To use the default buffer size of 16,384 bytes, use the AsStream(IRandomAccessStream) overload.

In den meisten Fällen wird die Leistung von Streamvorgängen durch Pufferung verbessert.In most situations, buffering improves the performance of stream operations. Sie können die Pufferung deaktivieren, indem Sie bufferSize auf NULL festlegen, aber dies sollten Sie nur tun, wenn Sie sicher sind, dass das Deaktivieren der Pufferung für Ihre Situation geeignet ist.You can disable buffering by setting bufferSize to zero, but you should do this only when you are sure that disabling buffering is appropriate for your situation.

Gilt für: