MemoryStream.Write Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

Write(ReadOnlySpan<Byte>)	Zapíše posloupnost bajtů obsažených v source do aktuálního datového proudu paměti a posune aktuální pozici v rámci tohoto datového proudu paměti o počet zapsaných bajtů.
Write(Byte[], Int32, Int32)	Zapíše blok bajtů do aktuálního datového proudu pomocí dat načtených z vyrovnávací paměti.

Write(ReadOnlySpan<Byte>)

Zdroj:

MemoryStream.cs

Zapíše posloupnost bajtů obsažených v source do aktuálního datového proudu paměti a posune aktuální pozici v rámci tohoto datového proudu paměti o počet zapsaných bajtů.

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>

Oblast paměti. Tato metoda zkopíruje obsah této oblasti do aktuálního paměťového streamu.

Write(Byte[], Int32, Int32)

Zdroj:

MemoryStream.cs

Zapíše blok bajtů do aktuálního datového proudu pomocí dat načtených z vyrovnávací paměti.

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[]

Vyrovnávací paměť pro zápis dat.

offset

Int32

Posun od nuly bajtů, při buffer kterém se má začít kopírovat bajty do aktuálního datového proudu.

count

Int32

Maximální počet bajtů k zápisu.

Výjimky

ArgumentNullException

buffer je null.

NotSupportedException

Datový proud nepodporuje psaní. Další informace najdete v tématu CanWrite.

-nebo-

Aktuální pozice je blíže než count bajty ke konci datového proudu a kapacitu nelze změnit.

ArgumentException

offset Odečtení od délky vyrovnávací paměti je menší než count.

ArgumentOutOfRangeException

offset nebo count jsou negativní.

IOException

Dojde k vstupně-výstupní chybě.

ObjectDisposedException

Aktuální instance datového proudu je uzavřena.

Příklady

Tento příklad kódu je součástí většího příkladu MemoryStream pro třídu .

// 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);

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

Poznámky

Tato metoda přepíše Write.

Parametr offset poskytuje posun prvního bajtu v buffer souboru, ze které se má zapisovat, a count parametr udává počet bajtů, které se mají zapsat. Pokud je operace zápisu úspěšná, aktuální pozice v rámci datového proudu se posune o počet zapsaných bajtů. Pokud dojde k výjimce, aktuální pozice v rámci datového proudu se nezmění.

S výjimkou vytvořeného MemoryStream pomocí parametru byte[] se operace zápisu na konci MemoryStream rozbalí MemoryStream.

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru