Stream.Write Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

Write(ReadOnlySpan<Byte>)	Gdy zastąpisz klasę pochodną, zapisuje sekwencję bajtów do bieżącego strumienia i rozwija bieżącą pozycję w tym strumieniu według liczby zapisanych bajtów.
Write(Byte[], Int32, Int32)	Gdy zastąpisz klasę pochodną, zapisuje sekwencję bajtów do bieżącego strumienia i rozwija bieżącą pozycję w tym strumieniu według liczby zapisanych bajtów.

Write(ReadOnlySpan<Byte>)

Źródło:

Stream.cs

Gdy zastąpisz klasę pochodną, zapisuje sekwencję bajtów do bieżącego strumienia i rozwija bieżącą pozycję w tym strumieniu według liczby zapisanych bajtów.

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

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

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

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

Parametry

buffer

ReadOnlySpan<Byte>

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

Uwagi

Użyj właściwości , CanWrite aby określić, czy bieżące wystąpienie obsługuje pisanie. WriteAsync Użyj metody , aby zapisać asynchronicznie do bieżącego strumienia.

Jeśli operacja zapisu zakończy się pomyślnie, pozycja w strumieniu przechodzi przez liczbę zapisanych bajtów. Jeśli wystąpi wyjątek, pozycja w strumieniu pozostaje niezmieniona.

Write(Byte[], Int32, Int32)

Źródło:

Stream.cs

Gdy zastąpisz klasę pochodną, zapisuje sekwencję bajtów do bieżącego strumienia i rozwija bieżącą pozycję w tym strumieniu według liczby zapisanych bajtów.

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

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

abstract member Write : byte[] * int * int -> unit

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

Parametry

buffer

Byte[]

Tablica bajtów. Ta metoda kopiuje bajty count z buffer do bieżącego strumienia.

offset

Int32

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

count

Int32

Liczba bajtów do zapisania do bieżącego strumienia.

Wyjątki

ArgumentException

Suma offset wartości i count jest większa niż długość buforu.

ArgumentNullException

buffer to null.

ArgumentOutOfRangeException

offset lub count jest ujemny.

IOException

Wystąpił błąd we/wy, taki jak określony plik.

NotSupportedException

Strumień nie obsługuje zapisywania.

ObjectDisposedException

Write(Byte[], Int32, Int32) został wywołany po zamknięciu strumienia.

Uwagi

Użyj właściwości , CanWrite aby określić, czy bieżące wystąpienie obsługuje pisanie. WriteAsync Użyj metody , aby zapisać asynchronicznie do bieżącego strumienia.

Jeśli operacja zapisu zakończy się pomyślnie, pozycja w strumieniu przechodzi przez liczbę zapisanych bajtów. Jeśli wystąpi wyjątek, pozycja w strumieniu pozostaje niezmieniona.

Zobacz też

• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku