FileStream.Write Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
Write(ReadOnlySpan<Byte>)	Zapíše posloupnost bajtů z rozsahu jen pro čtení do aktuálního datového proudu souboru a posune aktuální pozici v rámci tohoto datového proudu souboru o počet zapsaných bajtů.
Write(Byte[], Int32, Int32)	Zapíše blok bajtů do datového proudu souboru.

Write(ReadOnlySpan<Byte>)

Zdroj:

FileStream.cs

Zapíše posloupnost bajtů z rozsahu jen pro čtení do aktuálního datového proudu souboru a posune aktuální pozici v rámci tohoto datového proudu souboru 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 datového proudu souboru.

Výjimky

IOException

.NET 8 a novější verze: Základní potrubí je uzavřeno nebo odpojeno.

Poznámky

CanWrite Pomocí vlastnosti určete, zda aktuální instance podporuje zápis. Použijte metodu WriteAsync k asynchronnímu zápisu do aktuálního datového proudu.

Pokud je operace zápisu úspěšná, pozice v datovém proudu souboru se posune o počet zapsaných bajtů. Pokud dojde k výjimce, pozice v datovém proudu souboru zůstane beze změny.

Write(Byte[], Int32, Int32)

Zdroj:

FileStream.cs

Zapíše blok bajtů do datového proudu souboru.

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ěť obsahující data pro zápis do datového proudu.

offset

Int32

Posun bajtů array založený na nule, ze kterého chcete začít kopírovat bajty do datového proudu.

count

Int32

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

Výjimky

ArgumentNullException

array je null.

ArgumentException

offset a count popište neplatný rozsah v arraysouboru .

ArgumentOutOfRangeException

offset nebo count je negativní.

IOException

Došlo k vstupně-výstupní chybě.

nebo

Jiné vlákno mohlo způsobit neočekávanou změnu pozice popisovače souboru operačního systému.

nebo

.NET 8 a novější verze: Základní potrubí je uzavřeno nebo odpojeno.

ObjectDisposedException

Stream je zavřený.

NotSupportedException

Aktuální instance streamu nepodporuje zápis.

Příklady

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

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString =
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString),
        0, uniEncoding.GetByteCount(tempString));
}

// Write the original file data.
if fileStream.Length = 0 then
    let tempString = lastRecordText + string recordNumber
    fileStream.Write(uniEncoding.GetBytes tempString, 0, uniEncoding.GetByteCount tempString)

' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Poznámky

Tato metoda přepíše Write.

Parametr offset poskytuje posun bajtu ( array index vyrovnávací paměti), při kterém se má začít kopírovat, a count parametr poskytuje počet bajtů, které se zapíšou do datového proudu. Pokud je operace zápisu úspěšná, aktuální pozice datového proudu je rozšířena počtem zapsaných bajtů. Pokud dojde k výjimce, aktuální pozice datového proudu se nezmění.

Poznámka:

CanWrite Pomocí vlastnosti určete, zda aktuální instance podporuje zápis. Další informace najdete v tématu CanWrite.

Nepřerušujte vlákno, které provádí operaci zápisu. I když se může zdát, že se aplikace po odblokování vlákna úspěšně spustí, přerušení může snížit výkon a spolehlivost aplikace.

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

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