WindowsRuntimeStreamExtensions.AsStream Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.WindowsRuntime.dll

Sobrecargas

AsStream(IRandomAccessStream)	Converte um fluxo de acesso aleatório no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store.
AsStream(IRandomAccessStream, Int32)	Converte um fluxo de acesso aleatório no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store usando o tamanho do buffer especificado.

AsStream(IRandomAccessStream)

Importante

Esta API não está em conformidade com CLS.

Converte um fluxo de acesso aleatório no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store.

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

Parâmetros

windowsRuntimeStream

IRandomAccessStream

O objeto IRandomAccessStream do Windows Runtime a ser convertido.

Retornos

Stream

O fluxo convertido.

Atributos

CLSCompliantAttribute

Exceções

ArgumentNullException

windowsRuntimeStream é null.

Comentários

Observação

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo Stream. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (Guia de Programação em C#).

Um tamanho de buffer padrão de 16.384 bytes é usado ao converter o fluxo. Para especificar um tamanho de buffer diferente, use a AsStream(IRandomAccessStream, Int32) sobrecarga.

AsStream(IRandomAccessStream, Int32)

Importante

Esta API não está em conformidade com CLS.

Converte um fluxo de acesso aleatório no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store usando o tamanho do buffer especificado.

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

Parâmetros

windowsRuntimeStream

IRandomAccessStream

O objeto IRandomAccessStream do Windows Runtime a ser convertido.

bufferSize

Int32

O tamanho do buffer, em bytes. Este valor não pode ser negativo, mas pode ser 0 (zero) para desabilitar o buffering.

Retornos

Stream

O fluxo convertido.

Atributos

CLSCompliantAttribute

Exceções

ArgumentNullException

windowsRuntimeStream é null.

ArgumentOutOfRangeException

bufferSize é negativo.

Comentários

Observação

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo Stream. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (Guia de Programação em C#).

Você usa esse método para especificar um tamanho de buffer ao converter o fluxo. Para usar o tamanho do buffer padrão de 16.384 bytes, use a AsStream(IRandomAccessStream) sobrecarga.

Na maioria das situações, o buffer melhora o desempenho das operações de fluxo. Você pode desabilitar o buffer definindo bufferSize como zero, mas deve fazer isso somente quando tiver certeza de que desabilitar o buffer é apropriado para sua situação.