MemoryStream.GetBuffer Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.Runtime.dll
Zestaw:
System.Runtime.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
MemoryStream.cs
Źródło:
MemoryStream.cs
Źródło:
MemoryStream.cs

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 budowy bieżącego wystąpienia.

Wyjątki

UnauthorizedAccessException

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 , jednak ToArray tworzy kopię danych w pamięci.

Bufor może być również null.

Aby utworzyć MemoryStream wystąpienie z publicznie widocznym buforem, użyj polecenia MemoryStream, MemoryStream(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 bazowej tablicy bajtów jest zmieniany między wywołaniami. Aby uzyskać dodatkowe informacje, zobacz Capacity.

Uwaga

Ta metoda działa, gdy strumień pamięci jest zamknięty.

Dotyczy

Zobacz też