MemoryStream.GetBuffer Metoda

Definicja

Zwraca tablicę niepodpisanych bajtów, z których utworzono ten strumień.

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()

Zwraca

Byte[]

Tablica bajtów, z której utworzono ten strumień, lub tablica bazowa, jeśli tablica bajtów nie została podana konstruktorowi MemoryStream podczas konstruowania bieżącego wystąpienia.

Wyjątki

Wystąpienie MemoryStream nie zostało utworzone z publicznie widocznym buforem.

Uwagi

Należy pamiętać, że bufor zawiera przydzielone bajty, które mogą być nieużywane. Jeśli na przykład ciąg "test" jest zapisywany w MemoryStream obiekcie, długość buforu zwróconego z GetBuffer wynosi 256, a nie 4, z nieużywanymi 252 bajtami. Aby uzyskać tylko dane w buforze, użyj ToArray metody , ale ToArray tworzy kopię danych w pamięci.

Bufor może również mieć wartość null.

Aby utworzyć MemoryStream wystąpienie z publicznie widocznym buforem, użyj , MemoryStreamMemoryStream(Byte[], Int32, Int32, Boolean, Boolean)lub MemoryStream(Int32). Jeśli bieżący strumień jest możliwy do zmiany rozmiaru, dwa wywołania tej metody nie zwracają tej samej tablicy, jeśli rozmiar podstawowej tablicy bajtów jest zmieniany między wywołaniami. Aby uzyskać dodatkowe informacje, zobacz Capacity.

Note

Ta metoda działa po zamknięciu strumienia pamięci.

Dotyczy

Zobacz też