Compartilhar via


MemoryStream Construtores

Definição

Inicializa uma nova instância da classe MemoryStream.

Sobrecargas

MemoryStream()

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

MemoryStream(Byte[])

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

MemoryStream(Int32)

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

MemoryStream(Byte[], Boolean)

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

MemoryStream(Byte[], Int32, Int32)

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

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

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

MemoryStream()

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

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

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

Comentários

As propriedades CanRead, CanSeeke CanWrite estão definidas como true.

A capacidade do fluxo atual aumenta automaticamente quando você usa o método SetLength 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[])

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Inicializa uma nova instância não redimensionável da classe MemoryStream 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 propriedades CanRead, CanSeeke CanWrite estã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 lança UnauthorizedAccessException.

Confira também

Aplica-se a

MemoryStream(Int32)

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Inicializa uma nova instância da classe MemoryStream 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.

Exemplos

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

MemoryStream^ memStream = gcnew MemoryStream( 100 );
using(MemoryStream memStream = new MemoryStream(100))
Dim memStream As New MemoryStream(100)

Comentários

As propriedades CanRead, CanSeeke CanWrite estão definidas como true.

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

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

Confira também

Aplica-se a

MemoryStream(Byte[], Boolean)

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Inicializa uma nova instância não redimensionável da classe MemoryStream com base na matriz de bytes especificada com a propriedade CanWrite 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 propriedade CanWrite, que determina se o fluxo dá suporte à gravação.

Exceções

buffer é null.

Comentários

As propriedades CanRead e CanSeek estã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 lança UnauthorizedAccessException.

Confira também

Aplica-se a

MemoryStream(Byte[], Int32, Int32)

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Inicializa uma nova instância não redimensionável da classe MemoryStream 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 em buffer em que o fluxo começa.

count
Int32

O comprimento do fluxo em bytes.

Exceções

buffer é null.

index ou count é menor que zero.

O comprimento do buffer menos index é menor que count.

Comentários

As propriedades CanRead, CanSeeke CanWrite estão definidas como true, mas a capacidade não pode ser alterada. Capacity está 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 lança UnauthorizedAccessException. No entanto, você pode gravar no fluxo.

Confira também

Aplica-se a

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

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Inicializa uma nova instância não redimensionável da classe MemoryStream com base na região especificada de uma matriz de bytes, com a propriedade CanWrite 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 em buffer em que o fluxo começa.

count
Int32

O comprimento do fluxo em bytes.

writable
Boolean

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

Exceções

buffer é null.

index ou count são negativos.

O comprimento do buffer menos index é menor que count.

Comentários

As propriedades CanRead e CanSeek estão definidas como true. Capacity está 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 lança UnauthorizedAccessException. No entanto, você poderá gravar no fluxo se writable estiver true.

Confira também

Aplica-se a

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

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

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

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

index
Int32

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

count
Int32

O comprimento do fluxo em bytes.

writable
Boolean

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

publiclyVisible
Boolean

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

Exceções

buffer é null.

index ou count é negativo.

O comprimento do buffer menos index é menor que count.

Comentários

As propriedades CanRead e CanSeek estão definidas como true. Capacity está definido como count.

A nova instância de fluxo pode ser gravada, mas o Capacity da matriz de bytes subjacente não pode ser alterado. 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