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

Definition

Überlädt

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)
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>)

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>

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 umfangreicheren Beispiels für die Lock Methode.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.

Die offset -Parameter gibt den Offset des Bytes in array (Pufferindex) an, ab dem kopiert wird, und die count Parameter enthält die Anzahl der Bytes, 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, ist die aktuelle Position im Stream 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 der CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.Use 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 angezeigt werden kann, erfolgreich ausgeführt wird, nachdem der Thread nicht blockiert ist, kann die Unterbrechung, Leistung und Zuverlässigkeit Ihrer Anwendungsverzeichnis 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 Verzeichnisvorgänge, finden Sie unter e/a-Aufgaben.For a list of common file and directory operations, see Common I/O Tasks.

Siehe auch

Gilt für: