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）禁用缓冲的 0。

返回

Stream

已转换的流。

属性

CLSCompliantAttribute

例外

ArgumentNullException

windowsRuntimeStream 为 null。

ArgumentOutOfRangeException

bufferSize 为负数。

注解

注意

在 Visual Basic 和 C# 中，可以将此方法作为类型 Stream的任何对象的实例方法调用。 当使用实例方法语法调用此方法时，请省略第一个参数。 有关详细信息，请参阅 扩展方法 (Visual Basic) 或 扩展方法 (C# 编程指南) 。

转换流时，使用此方法指定缓冲区大小。 若要使用 16，384 字节的默认缓冲区大小，请使用 AsStream(IRandomAccessStream) 重载。

在大多数情况下，缓冲可以提高流操作的性能。 可以通过将 设置为 bufferSize 零来禁用缓冲，但仅当确定禁用缓冲适合你的情况时，才应执行此操作。