WindowsRuntimeStreamExtensions.AsStream 方法

定義

命名空間:

System.IO

組件:

System.Runtime.WindowsRuntime.dll

多載

AsStream(IRandomAccessStream)	將 Windows 執行時間中的隨機存取資料流轉換成適用於 Windows 市集應用程式的 .NET 中的受控數據流。
AsStream(IRandomAccessStream, Int32)	使用指定的緩衝區大小，將 Windows 執行時間中的隨機存取資料流轉換成適用於 Windows 市集應用程式的 .NET 受控數據流。

AsStream(IRandomAccessStream)

重要

此 API 不符合 CLS 規範。

將 Windows 執行時間中的隨機存取資料流轉換成適用於 Windows 市集應用程式的 .NET 中的受控數據流。

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 執行時間中的隨機存取資料流轉換成適用於 Windows 市集應用程式的 .NET 受控數據流。

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 設定為零來停用緩衝，但只有在確定停用緩衝處理適合您的情況時，才應該這麼做。