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