FileStream.Write Methode

Definitie

Naamruimte:
System.IO
Assembly:
netstandard.dll
Assembly's:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll

Overloads

Name Description
Write(ReadOnlySpan<Byte>)

Hiermee schrijft u een reeks bytes van een alleen-lezenbereik naar de huidige bestandsstroom en wordt de huidige positie binnen deze bestandsstroom verplaatst door het aantal geschreven bytes.
Write(Byte[], Int32, Int32)

Hiermee schrijft u een blok bytes naar de bestandsstroom.

Write(ReadOnlySpan<Byte>)

Hiermee schrijft u een reeks bytes van een alleen-lezenbereik naar de huidige bestandsstroom en wordt de huidige positie binnen deze bestandsstroom verplaatst door het aantal geschreven bytes.

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

Parameters

buffer
ReadOnlySpan<Byte>

Een geheugengebied. Met deze methode wordt de inhoud van deze regio gekopieerd naar de huidige bestandsstroom.

Uitzonderingen

IOException

.NET 8 en latere versies: De onderliggende pijp wordt gesloten of losgekoppeld.

Opmerkingen

Gebruik de CanWrite eigenschap om te bepalen of het huidige exemplaar ondersteuning biedt voor schrijven. Gebruik de WriteAsync methode om asynchroon naar de huidige stroom te schrijven.

Als de schrijfbewerking is geslaagd, wordt de positie binnen de bestandsstroom verder ontwikkeld door het aantal geschreven bytes. Als er een uitzondering optreedt, blijft de positie binnen de bestandsstroom ongewijzigd.

Van toepassing op

Write(Byte[], Int32, Int32)

Hiermee schrijft u een blok bytes naar de bestandsstroom.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public override void Write(byte[] array, int offset, int count);
override this.Write : byte[] * int * int -> unit
abstract member Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)

Parameters

array
Byte[]

De buffer met gegevens die naar de stream moeten worden geschreven.

offset
Int32

De byte-offset array op basis van nul waaruit bytes naar de stream moeten worden gekopieerd.

count
Int32

Het maximum aantal bytes dat moet worden geschreven.

Uitzonderingen

ArgumentNullException

array is null.

ArgumentException

offset en count beschrijf een ongeldig bereik in array.

ArgumentOutOfRangeException

offset of count is negatief.

IOException

Er is een I/O-fout opgetreden.

– of –

Een andere thread kan een onverwachte wijziging hebben veroorzaakt in de positie van de bestandsgreep van het besturingssysteem.

– of –

.NET 8 en latere versies: De onderliggende pijp wordt gesloten of losgekoppeld.

ObjectDisposedException

De stream is gesloten.

NotSupportedException

Het huidige stroomexemplaren bieden geen ondersteuning voor schrijven.

Voorbeelden

Dit codevoorbeeld maakt deel uit van een groter voorbeeld dat is opgegeven voor de Lock methode.

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

Opmerkingen

Deze methode overschrijft Write.

De offset parameter geeft de offset van de byte in array (de bufferindex) waarop moet worden gekopieerd en de count parameter geeft het aantal bytes dat naar de stream wordt geschreven. Als de schrijfbewerking is geslaagd, wordt de huidige positie van de stream geavanceerd met het aantal geschreven bytes. Als er een uitzondering optreedt, is de huidige positie van de stream ongewijzigd.

Note

Gebruik de CanWrite eigenschap om te bepalen of het huidige exemplaar ondersteuning biedt voor schrijven. Zie CanWritevoor meer informatie.

Onderbreek geen thread die een schrijfbewerking uitvoert. Hoewel de toepassing kan worden uitgevoerd nadat de thread is gedeblokkeerd, kan de onderbreking de prestaties en betrouwbaarheid van uw toepassing verminderen.

Zie Algemene I/O-taken voor een lijst met algemene bestands- en mapbewerkingen.

Zie ook

Van toepassing op