MemoryStream Construtores

Definição

Inicializa uma nova instância da classe MemoryStream.

Sobrecargas

Nome Description
MemoryStream()

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

MemoryStream(Byte[])

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na matriz de bytes especificada.

MemoryStream(Int32)

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

MemoryStream(Byte[], Boolean)

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na matriz de bytes especificada 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 uma matriz 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 uma matriz 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 uma matriz de bytes, com a CanWrite propriedade definida como especificada e a capacidade de chamar GetBuffer() definida conforme especificado.

MemoryStream()

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

public:
 MemoryStream();
public MemoryStream();
Public Sub New ()

Comentários

As CanReadpropriedades e as CanWriteCanSeekpropriedades são definidas como true.

A capacidade do fluxo atual aumenta automaticamente quando você usa o SetLength método para definir o comprimento como um valor maior que a capacidade do fluxo atual.

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

Confira também

Aplica-se a

MemoryStream(Byte[])

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na matriz de bytes especificada.

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[]

A matriz de bytes não assinados da qual criar o fluxo atual.

Exceções

buffer é null.

Comentários

As CanReadpropriedades e as CanWriteCanSeekpropriedades são definidas como true. Capacity é definido como o comprimento da matriz de bytes especificada. O novo fluxo pode ser gravado, mas não é redimensionável.

O comprimento do fluxo não pode ser definido como um valor maior que o comprimento inicial da matriz de bytes especificada; no entanto, o fluxo pode ser truncado (consulte SetLength).

Esse construtor não expõe o fluxo subjacente. GetBuffer UnauthorizedAccessExceptionlança .

Confira também

Aplica-se a

MemoryStream(Int32)

Inicializa uma nova instância da MemoryStream classe com uma 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 da matriz interna em bytes.

Exceções

capacity é negativo.

-ou-

Em versões .NET 11 e posteriores, capacity é maior 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)

Comentários

As CanReadpropriedades e as CanWriteCanSeekpropriedades são definidas como true.

A capacidade aumenta automaticamente quando você usa o SetLength método para definir o comprimento como um valor maior que a capacidade do fluxo atual. Com exceção de um MemoryStream parâmetro construído com um byte[], as operações de gravação no final de uma MemoryStream expansão do MemoryStream.

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

Confira também

Aplica-se a

MemoryStream(Byte[], Boolean)

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na matriz de bytes especificada 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[]

A matriz de bytes não assinados da qual criar esse fluxo.

writable
Boolean

A configuração da CanWrite propriedade, que determina se o fluxo dá suporte à gravação.

Exceções

buffer é null.

Comentários

As CanRead propriedades e as CanSeek propriedades são definidas como true. Capacity é definido como o comprimento da matriz de bytes especificada.

O comprimento do fluxo não pode ser definido como um valor maior que o comprimento inicial da matriz de bytes especificada; no entanto, o fluxo pode ser truncado (consulte SetLength).

Esse construtor não expõe o fluxo subjacente. GetBuffer UnauthorizedAccessExceptionlança .

Confira também

Aplica-se a

MemoryStream(Byte[], Int32, Int32)

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região (índice) especificada de uma matriz 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[]

A matriz de bytes não assinados da qual criar esse fluxo.

index
Int32

O índice no buffer qual o fluxo começa.

count
Int32

O comprimento do fluxo em bytes.

Exceções

buffer é null.

index ou count é menor que zero.

O tamanho do buffer menos index é menor que count.

Comentários

O CanRead, CanSeeke CanWrite as propriedades são todos definidos como true, mas a capacidade não pode ser alterada. Capacity é definido como count.

O comprimento do fluxo não pode ser definido como um valor maior que o comprimento inicial da matriz de bytes especificada; no entanto, o fluxo pode ser truncado (consulte SetLength).

Esse construtor não expõe o fluxo subjacente. GetBuffer UnauthorizedAccessExceptionlança . No entanto, você pode gravar no fluxo.

Confira também

Aplica-se a

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

Inicializa uma nova instância não redimensionável da MemoryStream classe com base na região especificada de uma matriz 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[]

A matriz de bytes não assinados da qual criar esse fluxo.

index
Int32

O índice no buffer qual o fluxo começa.

count
Int32

O comprimento do fluxo em bytes.

writable
Boolean

A configuração da CanWrite propriedade, que determina se o fluxo dá suporte à gravação.

Exceções

buffer é null.

index ou count são negativos.

O tamanho do buffer menos index é menor que count.

Comentários

As CanRead propriedades e as CanSeek propriedades são definidas como true. Capacity é definido como count.

O comprimento do fluxo não pode ser definido como um valor maior que o comprimento inicial da matriz de bytes especificada; no entanto, o fluxo pode ser truncado (consulte SetLength).

Esse construtor não expõe o fluxo subjacente. GetBuffer UnauthorizedAccessExceptionlança . No entanto, você pode gravar no fluxo se writable for true.

Confira também

Aplica-se a

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

Inicializa uma nova instância da MemoryStream classe com base na região especificada de uma matriz de bytes, com a CanWrite propriedade definida como especificada e a capacidade de chamar GetBuffer() definida conforme 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[]

A matriz de bytes não assinados da qual criar esse fluxo.

index
Int32

O índice no buffer qual o fluxo começa.

count
Int32

O comprimento do fluxo em bytes.

writable
Boolean

A configuração da CanWrite propriedade, que determina se o fluxo dá suporte à gravação.

publiclyVisible
Boolean

true para habilitar GetBuffer(), que retorna a matriz de bytes sem sinal da qual o fluxo foi criado; caso contrário, false.

Exceções

buffer é null.

index ou count é negativo.

O tamanho do buffer menos index é menor que count.

Comentários

As CanRead propriedades e as CanSeek propriedades são definidas como true. Capacity é definido como count.

A nova instância de fluxo pode ser gravada, mas a Capacity matriz de bytes subjacente não pode ser alterada. O comprimento do fluxo não pode ser definido como um valor maior que o comprimento inicial da matriz de bytes especificada; no entanto, o fluxo pode ser truncado (consulte SetLength).

Confira também

Aplica-se a