MemoryStream.Write Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
Write(ReadOnlySpan<Byte>) |
Zapíše posloupnost bajtů obsažených v |
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
- Zdroj:
- MemoryStream.cs
- 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> source);
public:
override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> source);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (source As ReadOnlySpan(Of Byte))
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))
Parametry
- sourcebuffer
- ReadOnlySpan<Byte>
Oblast paměti. Tato metoda zkopíruje obsah této oblasti do aktuálního paměťového streamu.
Platí pro
Write(Byte[], Int32, Int32)
- Zdroj:
- MemoryStream.cs
- Zdroj:
- MemoryStream.cs
- 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
buffer
je null
.
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.
offset
Odečtení od délky vyrovnávací paměti je menší než count
.
offset
nebo count
jsou negativní.
Dojde k vstupně-výstupní chybě.
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