語言

WindowsRuntimeStreamExtensions.AsStream 方法

定義

命名空間:
System.IO
組件:
System.Runtime.WindowsRuntime.dll

多載

名稱 Description
AsStream(IRandomAccessStream)

將 Windows 執行階段 中的隨機存取串流轉換為 .NET for Windows 商店應用程式中的受管理串流。
AsStream(IRandomAccessStream, Int32)

將Windows 執行階段中的隨機存取串流轉換為.NET中管理的串流，適用於指定的緩衝區大小Windows商店應用程式。

AsStream(IRandomAccessStream)

重要

此 API 不符合 CLS 規範。

將 Windows 執行階段 中的隨機存取串流轉換為 .NET for 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
Windows.Storage.Streams.IRandomAccessStream

Windows 執行階段 Windows.Storage.Streams.IRandomAccessStream 物件要轉換。

傳回

Stream

轉換後的溪流。

屬性
CLSCompliantAttribute

例外狀況

ArgumentNullException

windowsRuntimeStream 是 null。

備註

Note

在 Visual Basic 和 C# 中，你可以將此方法作為實例方法呼叫，適用於任何類型為 Stream 的物件。 當你使用 instance method 語法呼叫這個方法時，請省略第一個參數。 欲了解更多資訊，請參閱 Extension Methods （Visual Basic） 或 Extension Methods （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
Windows.Storage.Streams.IRandomAccessStream

Windows 執行階段 Windows.Storage.Streams.IRandomAccessStream 物件要轉換。

bufferSize
Int32

緩衝區的大小（以位元組為單位）。 此值不能為負值，但可以為 0（0）以禁用緩衝。

傳回

Stream

轉換後的溪流。

屬性
CLSCompliantAttribute

例外狀況

ArgumentNullException

windowsRuntimeStream 是 null。

ArgumentOutOfRangeException

bufferSize 為負數。

備註

Note

在 Visual Basic 和 C# 中，你可以將此方法作為實例方法呼叫，適用於任何類型為 Stream 的物件。 當你使用 instance method 語法呼叫這個方法時，請省略第一個參數。 欲了解更多資訊，請參閱 Extension Methods （Visual Basic） 或 Extension Methods （C# 程式設計指南）。

你用這個方法來指定緩衝區大小，來轉換串流。 要使用預設的緩衝區大小 16,384 位元組，請使用 overload AsStream(IRandomAccessStream) 。

在大多數情況下，緩衝能提升串流操作的效能。 你可以把緩衝區設 bufferSize 為零來停用緩衝，但只有在確定關閉緩衝適合你的情況時才應該這麼做。

適用於