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

Definizione

Overload

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

Scrive una sequenza di byte da un intervallo di sola lettura nel flusso di file corrente e sposta in avanti la posizione nel flusso di file in base al numero di byte scritti.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)

Scrive un blocco di byte nel flusso di file.Writes a block of bytes to the file stream.

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

Scrive una sequenza di byte da un intervallo di sola lettura nel flusso di file corrente e sposta in avanti la posizione nel flusso di file in base al numero di byte scritti.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))

Parametri

buffer
ReadOnlySpan<Byte>

Un'area di memoria.A region of memory. Questo metodo copia il contenuto di questa area nel flusso di file corrente.This method copies the contents of this region to the current file stream.

Commenti

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing. Usare il WriteAsync metodo per scrivere in modo asincrono nel flusso corrente.Use the WriteAsync method to write asynchronously to the current stream.

Se l'operazione di scrittura ha esito positivo, la posizione all'interno del flusso di file avanza per il numero di byte scritti.If the write operation is successful, the position within the file stream advances by the number of bytes written. Se si verifica un'eccezione, la posizione all'interno del flusso di file rimane invariata.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)

Scrive un blocco di byte nel flusso di file.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)

Parametri

array
Byte[]

Buffer contenente i dati da scrivere nel flusso.The buffer containing data to write to the stream.

offset
Int32 Int32 Int32 Int32

Offset dei byte in base zero in array da cui iniziare la copia dei byte nel flusso.The zero-based byte offset in array from which to begin copying bytes to the stream.

count
Int32 Int32 Int32 Int32

Numero massimo di byte da scrivere.The maximum number of bytes to write.

Eccezioni

offset e count descrivono un intervallo non valido in array.offset and count describe an invalid range in array.

Si è verificato un errore di I/O.An I/O error occurred.

-oppure--or-

Un altro thread può aver causato una modifica imprevista nella posizione dell'handle di file del sistema operativo.Another thread may have caused an unexpected change in the position of the operating system's file handle.

L'istanza del flusso corrente non supporta la scrittura.The current stream instance does not support writing.

Esempi

Questo esempio di codice fa parte di un esempio più ampio fornito Lock per il metodo.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

Commenti

Questo metodo esegue l'override del metodo Write.This method overrides Write.

Il offset parametro fornisce l'offset del byte in array (indice buffer) in corrispondenza del quale iniziare la copia e il count parametro restituisce il numero di byte che verranno scritti nel flusso.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. Se l'operazione di scrittura ha esito positivo, la posizione corrente del flusso viene avanzata in base al numero di byte scritti.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Se si verifica un'eccezione, la posizione corrente del flusso è invariata.If an exception occurs, the current position of the stream is unchanged.

Nota

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing. Per altre informazioni, vedere CanWrite.For additional information, see CanWrite.

Non interrompere un thread che sta eseguendo un'operazione di scrittura.Do not interrupt a thread that is performing a write operation. Sebbene l'applicazione possa sembrare eseguita correttamente dopo che il thread è stato sbloccato, l'interruzione può ridurre le prestazioni e l'affidabilità dell'applicazione.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Per un elenco delle operazioni comuni di file e directory, vedere attività di I/O comuni.For a list of common file and directory operations, see Common I/O Tasks.

Vedi anche

Si applica a