FileStream.Write FileStream.Write FileStream.Write FileStream.Write Method

Definition

Überlädt

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Schreibt eine Bytesequenz aus einer schreibgeschützten Spanne in den aktuellen Dateidatenstrom und setzt die aktuelle Position in diesem Dateidatenstrom um die Anzahl der geschriebenen Bytes nach vorn.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Schreibt einen Block von Bytes in den Dateistream.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Schreibt eine Bytesequenz aus einer schreibgeschützten Spanne in den aktuellen Dateidatenstrom und setzt die aktuelle Position in diesem Dateidatenstrom um die Anzahl der geschriebenen Bytes nach vorn.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

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

Parameter

buffer
ReadOnlySpan<Byte>

Ein Bereich im Arbeitsspeicher.A region of memory. Diese Methode kopiert den Inhalt dieses Bereichs in den aktuellen Dateidatenstrom.This method copies the contents of this region to the current file stream.

Hinweise

Verwenden Sie CanWrite die-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstütztUse the CanWrite property to determine whether the current instance supports writing. Verwenden Sie WriteAsync die-Methode, um asynchron in den aktuellen Stream zu schreiben.Use the WriteAsync method to write asynchronously to the current stream.

Wenn der Schreibvorgang erfolgreich ist, wird die Position innerhalb des Datei Datenstroms um die Anzahl der geschriebenen Bytes fortgesetzt.If the write operation is successful, the position within the file stream advances by the number of bytes written. Wenn eine Ausnahme auftritt, bleibt die Position im Dateistream unverändert.If an exception occurs, the position within the file stream remains unchanged.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Schreibt einen Block von Bytes in den Dateistream.Writes a block of bytes to the file stream.

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
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)

Parameter

array
Byte[]

Der Puffer mit den Daten, die in den Stream geschrieben werden sollen.The buffer containing data to write to the stream.

offset
Int32 Int32 Int32 Int32

Der nullbasierte Byteoffset im array, ab dem Bytes in den Stream kopiert werden.The zero-based byte offset in array from which to begin copying bytes to the stream.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu schreibenden Bytes.The maximum number of bytes to write.

Ausnahmen

offset und count bezeichnen einen ungültigen Bereich in array.offset and count describe an invalid range in array.

offset oder count ist ein negativer Wert.offset or count is negative.

E/A-FehlerAn I/O error occurred.

- oder --or-

Ein anderer Thread hat möglicherweise eine unerwartete Änderung der Position des Dateihandles des Betriebssystems verursacht.Another thread may have caused an unexpected change in the position of the operating system's file handle.

Die aktuelle Streaminstanz unterstützt keine Schreibvorgänge.The current stream instance does not support writing.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Lock -Methode bereitgestellt wird.This code example is part of a larger example provided for the Lock method.

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

// 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 aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Hinweise

Diese Methode überschreibt Write.This method overrides Write.

Der offset -Parameter gibt den Offset des Bytes in array (den Puffer Index) an, an dem mit dem Kopieren begonnen count werden soll, und der-Parameter gibt die Anzahl der Bytes an, die in den Stream geschrieben werden.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin copying, and the count parameter gives the number of bytes that will be written to the stream. Wenn der Schreibvorgang erfolgreich ist, wird die aktuelle Position des Streams um die Anzahl der geschriebenen Bytes erweitert.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Wenn eine Ausnahme auftritt, wird die aktuelle Position des Streams unverändert.If an exception occurs, the current position of the stream is unchanged.

Hinweis

Verwenden Sie CanWrite die-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstütztUse the CanWrite property to determine whether the current instance supports writing. Weitere Informationen finden Sie unter CanWrite.For additional information, see CanWrite.

Unterbrechen Sie keinen Thread, der einen Schreibvorgang ausführt.Do not interrupt a thread that is performing a write operation. Obwohl die Anwendung nach der Blockierung des Threads möglicherweise erfolgreich ausgeführt wird, kann die Unterbrechung die Leistung und Zuverlässigkeit Ihrer Anwendung verringern.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Eine Liste der allgemeinen Datei-und Verzeichnis Vorgänge finden Sie unter Allgemeine e/a-Aufgaben.For a list of common file and directory operations, see Common I/O Tasks.

Siehe auch

Gilt für: