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 设置为零来禁用缓冲，但只有在确保禁用缓冲适合你的情况时，才应执行此操作。