WindowsRuntimeStreamExtensions.AsStream Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
AsStream(IRandomAccessStream) |
Konvertiert einen Datenstrom mit zufälligem Zugriff in der Windows-Runtime in einen verwalteten Stream in .NET für Windows Store-Apps. |
AsStream(IRandomAccessStream, Int32) |
Konvertiert einen Datenstrom mit zufälligem Zugriff in der Windows-Runtime in einen verwalteten Datenstrom in .NET für Windows Store-Apps mit der angegebenen Puffergröße. |
AsStream(IRandomAccessStream)
Wichtig
Diese API ist nicht CLS-kompatibel.
Konvertiert einen Datenstrom mit zufälligem Zugriff in der Windows-Runtime in einen verwalteten Stream in .NET für 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);
[<System.CLSCompliant(false)>]
static member AsStream : Windows.Storage.Streams.IRandomAccessStream -> System.IO.Stream
<Extension()>
Public Function AsStream (windowsRuntimeStream As IRandomAccessStream) As Stream
Parameter
- windowsRuntimeStream
- IRandomAccessStream
Das zu konvertierende Windows-Runtime-IRandomAccessStream-Objekt.
Gibt zurück
Der konvertierte Datenstrom.
- Attribute
Ausnahmen
windowsRuntimeStream
ist null
.
Hinweise
Anmerkung
In Visual Basic und C# können Sie diese Methode als Instanzmethode für jedes Objekt vom Typ Streamaufrufen. Wenn Sie die Instanzmethodensyntax verwenden, um diese Methode aufzurufen, lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) oder Erweiterungsmethoden (C#-Programmierhandbuch).
Beim Konvertieren des Datenstroms wird eine Standardpuffergröße von 16.384 Byte verwendet. Verwenden Sie die AsStream(IRandomAccessStream, Int32) Überladung, um eine andere Puffergröße anzugeben.
Gilt für:
AsStream(IRandomAccessStream, Int32)
Wichtig
Diese API ist nicht CLS-kompatibel.
Konvertiert einen Datenstrom mit zufälligem Zugriff in der Windows-Runtime in einen verwalteten Datenstrom in .NET für Windows Store-Apps mit der angegebenen Puffergröße.
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
Parameter
- windowsRuntimeStream
- IRandomAccessStream
Das zu konvertierende Windows-Runtime-IRandomAccessStream-Objekt.
- bufferSize
- Int32
Die Größe des Puffers in Bytes. Dieser Wert kann nicht negativ sein, kann jedoch 0 (Null) sein, um die Pufferung zu deaktivieren.
Gibt zurück
Der konvertierte Datenstrom.
- Attribute
Ausnahmen
windowsRuntimeStream
ist null
.
bufferSize
ist negativ.
Hinweise
Anmerkung
In Visual Basic und C# können Sie diese Methode als Instanzmethode für jedes Objekt vom Typ Streamaufrufen. Wenn Sie die Instanzmethodensyntax verwenden, um diese Methode aufzurufen, lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) oder Erweiterungsmethoden (C#-Programmierhandbuch).
Mit dieser Methode geben Sie beim Konvertieren des Datenstroms eine Puffergröße an. Um die Standardpuffergröße von 16.384 Byte zu verwenden, verwenden Sie die AsStream(IRandomAccessStream) Überladung.
In den meisten Situationen verbessert die Pufferung die Leistung von Datenstromvorgängen. Sie können die Pufferung deaktivieren, indem Sie bufferSize
auf Null festlegen. Dies sollten Sie jedoch nur tun, wenn Sie sicher sind, dass das Deaktivieren der Pufferung für Ihre Situation geeignet ist.