FileStream.Write Metod

Definition

Namnområde:
System.IO
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
netstandard.dll
Sammansättningar:
mscorlib.dll, System.IO.FileSystem.dll
Sammansättning:
System.IO.FileSystem.dll
Sammansättning:
mscorlib.dll

Överlagringar

Name Description
Write(ReadOnlySpan<Byte>)

Skriver en sekvens med byte från ett skrivskyddat intervall till den aktuella filströmmen och flyttar fram den aktuella positionen i den här filströmmen med antalet skrivna byte.
Write(Byte[], Int32, Int32)

Skriver ett byteblock till filströmmen.

Write(ReadOnlySpan<Byte>)

Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs

Skriver en sekvens med byte från ett skrivskyddat intervall till den aktuella filströmmen och flyttar fram den aktuella positionen i den här filströmmen med antalet skrivna byte.

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

Parametrar

buffer
ReadOnlySpan<Byte>

En region med minne. Den här metoden kopierar innehållet i den här regionen till den aktuella filströmmen.

Undantag

IOException

.NET 8 och senare versioner: Det underliggande röret är stängt eller frånkopplat.

Kommentarer

Använd egenskapen CanWrite för att avgöra om den aktuella instansen stöder skrivning. WriteAsync Använd metoden för att skriva asynkront till den aktuella strömmen.

Om skrivåtgärden lyckas ökar positionen i filströmmen med antalet skrivna byte. Om ett undantag inträffar förblir positionen i filströmmen oförändrad.

Gäller för

Write(Byte[], Int32, Int32)

Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs
Källa:
FileStream.cs

Skriver ett byteblock till filströmmen.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write(byte[] array, int offset, int count);
public override void Write(byte[] buffer, int offset, int count);
override this.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)
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametrar

arraybuffer
Byte[]

Bufferten som innehåller data som ska skrivas till dataströmmen.

offset
Int32

Den nollbaserade byteförskjutningen array där byte ska börja kopieras till strömmen.

count
Int32

Det maximala antalet byte som ska skrivas.

Undantag

ArgumentNullException

array är null.

ArgumentException

offset och count beskriva ett ogiltigt intervall i array.

ArgumentOutOfRangeException

offset eller count är negativ.

IOException

Ett I/O-fel uppstod.

-eller-

En annan tråd kan ha orsakat en oväntad ändring i operativsystemets filhandtag.

-eller-

.NET 8 och senare versioner: Det underliggande röret är stängt eller frånkopplat.

ObjectDisposedException

Strömmen är stängd.

NotSupportedException

Den aktuella ströminstansen stöder inte skrivning.

Exempel

Det här kodexemplet är en del av ett större exempel för Lock metoden.

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

Kommentarer

Den här metoden åsidosätter Write.

Parametern offset ger förskjutningen av byte i array (buffertindexet) där kopieringen ska börja, och parametern count ger det antal byte som ska skrivas till dataströmmen. Om skrivåtgärden lyckas avanceras strömmens aktuella position med antalet skrivna byte. Om ett undantag inträffar ändras strömmens aktuella position.

Note

Använd egenskapen CanWrite för att avgöra om den aktuella instansen stöder skrivning. Mer information finns i CanWrite.

Avbryt inte en tråd som utför en skrivåtgärd. Även om programmet kan verka fungera när tråden har avblockerats kan avbrottet minska programmets prestanda och tillförlitlighet.

En lista över vanliga fil- och katalogåtgärder finns i Vanliga I/O-uppgifter.

Se även

Gäller för