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.

[System.CLSCompliant(false)]
public static System.IO.Stream AsStream (this Windows.Storage.Streams.IRandomAccessStream windowsRuntimeStream);

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ê usa a sintaxe do 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 sobrecarga de AsStream(IRandomAccessStream, Int32).

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.

[System.CLSCompliant(false)]
public static System.IO.Stream AsStream (this Windows.Storage.Streams.IRandomAccessStream windowsRuntimeStream, int bufferSize);

Parâmetros

windowsRuntimeStream

IRandomAccessStream

O objeto IRandomAccessStream do Windows Runtime a ser convertido.

bufferSize

Int32

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

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ê usa a sintaxe do 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 sobrecarga de AsStream(IRandomAccessStream).

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.