MemoryStream.Write Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
Write(ReadOnlySpan<Byte>)	Zapisuje sekwencję bajtów zawartych w source bieżącym strumieniu pamięci i przechodzi bieżącą pozycję w tym strumieniu pamięci przez liczbę zapisanych bajtów.
Write(Byte[], Int32, Int32)	Zapisuje blok bajtów w bieżącym strumieniu przy użyciu danych odczytanych z buforu.

Write(ReadOnlySpan<Byte>)

Źródło:

MemoryStream.cs

Zapisuje sekwencję bajtów zawartych w source bieżącym strumieniu pamięci i przechodzi bieżącą pozycję w tym strumieniu pamięci przez liczbę zapisanych bajtów.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write(ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parametry

buffer

ReadOnlySpan<Byte>

Region pamięci. Ta metoda kopiuje zawartość tego regionu do bieżącego strumienia pamięci.

Write(Byte[], Int32, Int32)

Źródło:

MemoryStream.cs

Zapisuje blok bajtów w bieżącym strumieniu przy użyciu danych odczytanych z buforu.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write(byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametry

buffer

Byte[]

Bufor do zapisywania danych z.

offset

Int32

Przesunięcie bajtu opartego na zera, w buffer którym rozpoczyna się kopiowanie bajtów do bieżącego strumienia.

count

Int32

Maksymalna liczba bajtów do zapisu.

Wyjątki

ArgumentNullException

Parametr buffer ma wartość null.

NotSupportedException

Strumień nie obsługuje zapisu. Aby uzyskać dodatkowe informacje, zobacz CanWrite.

— lub —

Bieżąca pozycja jest bliższa niż count bajty na końcu strumienia i nie można modyfikować pojemności.

ArgumentException

offset odjęcie od długości buforu jest mniejsze niż count.

ArgumentOutOfRangeException

offset lub count są ujemne.

IOException

Występuje błąd we/wy.

ObjectDisposedException

Bieżące wystąpienie strumienia jest zamknięte.

Przykłady

Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy MemoryStream.

// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);

' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)

Uwagi

Ta metoda zastępuje metodę Write.

Parametr offset daje przesunięcie pierwszego bajtu do buffer zapisu, a count parametr daje liczbę bajtów do zapisu. Jeśli operacja zapisu zakończy się pomyślnie, bieżące położenie w strumieniu jest zaawansowane przez liczbę zapisanych bajtów. Jeśli wystąpi wyjątek, bieżąca pozycja w strumieniu pozostaje niezmieniona.

MemoryStream Z wyjątkiem konstrukcji z parametrem bajtu[] operacje zapisu na końcu MemoryStream rozszerzenia MemoryStream.

Zobacz też

• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku