MemoryStream.GetBuffer Método

Definición

Devuelve la matriz de bytes sin signo a partir de la cual se creó esta secuencia.Returns the array of unsigned bytes from which this stream was created.

public:
 virtual cli::array <System::Byte> ^ GetBuffer();
public virtual byte[] GetBuffer ();
abstract member GetBuffer : unit -> byte[]
override this.GetBuffer : unit -> byte[]
Public Overridable Function GetBuffer () As Byte()

Devoluciones

Byte[]

Matriz de bytes desde la que se creó la secuencia o la matriz subyacente si la matriz de bytes no se proporcionó al constructor MemoryStream durante la construcción de la instancia actual.The byte array from which this stream was created, or the underlying array if a byte array was not provided to the MemoryStream constructor during construction of the current instance.

Excepciones

La instancia de MemoryStream no se ha creado con un búfer públicamente visible.The MemoryStream instance was not created with a publicly visible buffer.

Comentarios

Tenga en cuenta que el búfer contiene bytes asignados que podrían no usarse.Note that the buffer contains allocated bytes which might be unused. Por ejemplo, si la cadena "Test" se escribe en el MemoryStream objeto, la longitud del búfer GetBuffer devuelto es 256, no 4, con 252 bytes sin usar.For example, if the string "test" is written into the MemoryStream object, the length of the buffer returned from GetBuffer is 256, not 4, with 252 bytes unused. Para obtener solo los datos del búfer, use el ToArray método; sin embargo, ToArray crea una copia de los datos en la memoria.To obtain only the data in the buffer, use the ToArray method; however, ToArray creates a copy of the data in memory.

El búfer también puede ser null.The buffer can also be null.

Para crear una MemoryStream instancia de con un búfer visible públicamente MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)use, MemoryStream(Int32)o.To create a MemoryStream instance with a publicly visible buffer, use MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean), or MemoryStream(Int32). Si el flujo actual es ajustable, dos llamadas a este método no devuelven la misma matriz si se cambia el tamaño de la matriz de bytes subyacente entre las llamadas.If the current stream is resizable, two calls to this method do not return the same array if the underlying byte array is resized between calls. Para obtener información adicional, vea Capacity.For additional information, see Capacity.

Nota

Este método funciona cuando se cierra la secuencia de memoria.This method works when the memory stream is closed.

Se aplica a

Consulte también: