MemoryStream Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe MemoryStream.
Sobrecargas
| MemoryStream() |
Inicializa uma nova instância da classe MemoryStream com uma capacidade expansível inicializada em 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 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 o conjunto de propriedades CanWrite especificado e a capacidade de chamar GetBuffer() definida de acordo com a especificação. |
MemoryStream()
Inicializa uma nova instância da classe MemoryStream com uma capacidade expansível inicializada em zero.
public:
MemoryStream();public MemoryStream ();Public Sub New ()Comentários
As CanReadpropriedades e CanWrite as CanSeekpropriedades 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 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.MemoryStreamPublic Sub New (buffer As Byte())Parâmetros
- buffer
- Byte[]
A matriz de bytes sem sinal com base na qual o fluxo atual será criado.
Exceções
buffer é null.
Comentários
As CanReadpropriedades e CanWrite as CanSeekpropriedades 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. GetBufferUnauthorizedAccessExceptionlança .
Confira também
Aplica-se a
MemoryStream(Int32)
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.MemoryStreamPublic 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 MemoryStream classe.
MemoryStream^ memStream = gcnew MemoryStream( 100 );
using(MemoryStream memStream = new MemoryStream(100))
Dim memStream As New MemoryStream(100)
Comentários
As CanReadpropriedades e CanWrite as CanSeekpropriedades 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 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.MemoryStreamPublic Sub New (buffer As Byte(), writable As Boolean)Parâmetros
- buffer
- Byte[]
A matriz de bytes sem sinal da qual este fluxo deve ser criado.
- writable
- Boolean
A configuração da propriedade CanWrite, que determina se o fluxo dá suporte à gravação.
Exceções
buffer é null.
Comentários
As CanRead propriedades e CanSeek as 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. GetBufferUnauthorizedAccessExceptionlança .
Confira também
Aplica-se a
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 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.MemoryStreamPublic Sub New (buffer As Byte(), index As Integer, count As Integer)Parâmetros
- buffer
- Byte[]
A matriz de bytes sem sinal da qual este fluxo deve ser criado.
- index
- Int32
O índice para o buffer no 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
As CanReadpropriedades , CanSeeke CanWrite as propriedades estão definidas 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. GetBufferUnauthorizedAccessExceptionlanç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 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.MemoryStreamPublic Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean)Parâmetros
- buffer
- Byte[]
A matriz de bytes sem sinal da qual este fluxo deve ser criado.
- index
- Int32
O índice em buffer no qual 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 é negativo.
O tamanho do buffer menos index é menor que count.
Comentários
As CanRead propriedades e CanSeek as 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. GetBufferUnauthorizedAccessExceptionlanç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 classe MemoryStream com base na região especificada de uma matriz de bytes, com o conjunto de propriedades CanWrite especificado e a capacidade de chamar GetBuffer() definida de acordo com a especificação.
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.MemoryStreamPublic 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 sem sinal da qual este fluxo deve ser criado.
- index
- Int32
O índice para o buffer no qual 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 para habilitar o 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 CanSeek as 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).