MemoryStream Construtores

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.IO.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da MemoryStream classe.

Sobrecargas

Name	Description
MemoryStream()	Inicializa uma nova instância da MemoryStream classe com capacidade expansível inicializada a zero.
MemoryStream(Byte[])	Inicializa uma nova instância não redimensionável da MemoryStream classe com base no array de bytes especificado.
MemoryStream(Int32)	Inicializa uma nova instância da MemoryStream classe com capacidade expansível inicializada conforme especificado.
MemoryStream(Byte[], Boolean)	Inicializa uma nova instância não redimensionável da MemoryStream classe com base no array de bytes especificado com a CanWrite propriedade definida conforme especificado.
MemoryStream(Byte[], Int32, Int32)	Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região (índice) especificada de um array de bytes.
MemoryStream(Byte[], Int32, Int32, Boolean)	Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região especificada de um array de bytes, com a CanWrite propriedade definida conforme especificado.
MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)	Inicializa uma nova instância da MemoryStream classe com base na região especificada de um array de bytes, com a CanWrite propriedade definida como especificada, e a capacidade de chamar GetBuffer() o conjunto como especificado.

MemoryStream()

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância da MemoryStream classe com capacidade expansível inicializada a zero.

public:
 MemoryStream();

public MemoryStream();

Public Sub New ()

Observações

As CanReadpropriedades , CanSeek, e CanWrite estão todas definidas para true.

A capacidade do fluxo atual aumenta automaticamente quando se usa o SetLength método para definir o comprimento para um valor superior à capacidade do fluxo atual.

Este construtor expõe o fluxo subjacente, que GetBuffer retorna.

Ver também

Aplica-se a

MemoryStream(Byte[])

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância não redimensionável da MemoryStream classe com base no array de bytes especificado.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer);

public MemoryStream(byte[] buffer);

new System.IO.MemoryStream : byte[] -> System.IO.MemoryStream

Public Sub New (buffer As Byte())

Parâmetros

buffer: Byte[]

O array de bytes não assinados a partir do qual criar o fluxo atual.

Exceções

ArgumentNullException

buffer é null.

Observações

As CanReadpropriedades , CanSeek, e CanWrite estão todas definidas para true. Capacity está definido para o comprimento do array de bytes especificado. O novo fluxo pode ser escrito, mas não é redimensionável.

O comprimento do fluxo não pode ser definido para um valor superior ao comprimento inicial do array de bytes especificado; no entanto, o fluxo pode ser truncado (ver SetLength).

Este construtor não expõe o fluxo subjacente. GetBuffer lança UnauthorizedAccessException.

Ver também

Aplica-se a

MemoryStream(Int32)

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância da MemoryStream classe com capacidade expansível inicializada conforme especificado.

public:
 MemoryStream(int capacity);

public MemoryStream(int capacity);

new System.IO.MemoryStream : int -> System.IO.MemoryStream

Public Sub New (capacity As Integer)

Parâmetros

capacity: Int32

O tamanho inicial do array interno em bytes.

Exceções

ArgumentOutOfRangeException

capacity é negativo.

-ou-

Em versões .NET 11 e posteriores, capacity é maior do que Array.MaxLength.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a MemoryStream classe.

using(MemoryStream memStream = new MemoryStream(100))

Dim memStream As New MemoryStream(100)

Observações

As CanReadpropriedades , CanSeek, e CanWrite estão todas definidas para true.

A capacidade aumenta automaticamente quando se usa o SetLength método para definir o comprimento para um valor superior à capacidade do fluxo atual. Exceto para um MemoryStream construído com um parâmetro de byte[], as operações de escrita no final de um MemoryStream expandem o MemoryStream.

Este construtor expõe o fluxo subjacente que GetBuffer retorna.

Ver também

Aplica-se a

MemoryStream(Byte[], Boolean)

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância não redimensionável da MemoryStream classe com base no array de bytes especificado com a CanWrite propriedade definida conforme especificado.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, bool writable);

public MemoryStream(byte[] buffer, bool writable);

new System.IO.MemoryStream : byte[] * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), writable As Boolean)

Parâmetros

buffer: Byte[]

O array de bytes sem assinatura a partir do qual criar este fluxo.

writable: Boolean

A definição da CanWrite propriedade, que determina se o fluxo suporta a escrita.

Exceções

ArgumentNullException

buffer é null.

Observações

As CanRead propriedades e CanSeek são ambas atribuídas a true. Capacity está definido para o comprimento do array de bytes especificado.

O comprimento do fluxo não pode ser definido para um valor superior ao comprimento inicial do array de bytes especificado; no entanto, o fluxo pode ser truncado (ver SetLength).

Este construtor não expõe o fluxo subjacente. GetBuffer lança UnauthorizedAccessException.

Ver também

Aplica-se a

MemoryStream(Byte[], Int32, Int32)

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região (índice) especificada de um array de bytes.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count);

public MemoryStream(byte[] buffer, int index, int count);

new System.IO.MemoryStream : byte[] * int * int -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer)

Parâmetros

buffer: Byte[]

O array de bytes sem assinatura a partir do qual criar este fluxo.

index: Int32

O índice em buffer que o fluxo começa.

count: Int32

O comprimento do fluxo em bytes.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é inferior a zero.

ArgumentException

O comprimento do buffer menos index é menor que count.

Observações

As CanReadpropriedades , CanSeek, e CanWrite estão todas definidas para true, mas a capacidade não pode ser alterada. Capacity está definido como count.

O comprimento do fluxo não pode ser definido para um valor superior ao comprimento inicial do array de bytes especificado; no entanto, o fluxo pode ser truncado (ver SetLength).

Este construtor não expõe o fluxo subjacente. GetBuffer lança UnauthorizedAccessException. No entanto, podes escrever para o stream.

Ver também

Aplica-se a

MemoryStream(Byte[], Int32, Int32, Boolean)

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região especificada de um array de bytes, com a CanWrite propriedade definida conforme especificado.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable);

public MemoryStream(byte[] buffer, int index, int count, bool writable);

new System.IO.MemoryStream : byte[] * int * int * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean)

Parâmetros

buffer: Byte[]

O array de bytes sem assinatura a partir do qual criar este fluxo.

index: Int32

O índice em buffer onde o fluxo começa.

count: Int32

O comprimento do fluxo em bytes.

writable: Boolean

A definição da CanWrite propriedade, que determina se o fluxo suporta a escrita.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count são negativos.

ArgumentException

O comprimento do buffer menos index é menor que count.

Observações

As CanRead propriedades e CanSeek são ambas atribuídas a true. Capacity está definido como count.

O comprimento do fluxo não pode ser definido para um valor superior ao comprimento inicial do array de bytes especificado; no entanto, o fluxo pode ser truncado (ver SetLength).

Este construtor não expõe o fluxo subjacente. GetBuffer lança UnauthorizedAccessException. No entanto, pode escrever no fluxo se writable for true.

Ver também

Aplica-se a

MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Origem:: MemoryStream.cs

Inicializa uma nova instância da MemoryStream classe com base na região especificada de um array de bytes, com a CanWrite propriedade definida como especificada, e a capacidade de chamar GetBuffer() o conjunto como especificado.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable, bool publiclyVisible);

public MemoryStream(byte[] buffer, int index, int count, bool writable, bool publiclyVisible);

new System.IO.MemoryStream : byte[] * int * int * bool * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean, publiclyVisible As Boolean)

Parâmetros

buffer: Byte[]

O array de bytes sem assinatura a partir do qual criar este fluxo.

index: Int32

O índice em buffer que o fluxo começa.

count: Int32

O comprimento do fluxo em bytes.

writable: Boolean

A definição da CanWrite propriedade, que determina se o fluxo suporta a escrita.

publiclyVisible: Boolean

true para ativar GetBuffer(), que devolve o array de bytes sem sinal a partir do qual o fluxo foi criado; caso contrário, false.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é negativo.

ArgumentException

O comprimento do buffer menos index é menor que count.

Observações

As CanRead propriedades e CanSeek são ambas atribuídas a true. Capacity está definido como count.

A nova instância do fluxo pode ser escrita, mas a Capacity do array de bytes subjacente não pode ser alterada. O comprimento do fluxo não pode ser definido para um valor superior ao comprimento inicial do array de bytes especificado; no entanto, o fluxo pode ser truncado (ver SetLength).

Ver também

Aplica-se a

Comentários

Esta página foi útil?