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 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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo
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
- de E/S de Fluxo e Arquivo
- Como ler texto de um arquivo
- Como gravar texto em um arquivo