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

Определение

Перегрузки

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)

Записывает блок байтов в файловый поток.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))

Параметры

buffer
ReadOnlySpan<Byte>

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

Записывает блок байтов в файловый поток.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)

Параметры

array
Byte[]

Буфер, содержащий данные для записи в поток.The buffer containing data to write to the stream.

offset
Int32 Int32 Int32 Int32

Смещение байтов (начиная с нуля) в объекте array, с которого начинается копирование байтов в поток.The zero-based byte offset in array from which to begin copying bytes to the stream.

count
Int32 Int32 Int32 Int32

Максимальное число байтов для записи.The maximum number of bytes to write.

Исключения

offset и count описывают недопустимый диапазон в array.offset and count describe an invalid range in array.

offset или count является отрицательным значением.offset or count is negative.

Ошибка ввода/вывода.An I/O error occurred.

-или--or-

Возможно, другой поток вызвал непредвиденное изменение положения дескриптора файла операционной системы.Another thread may have caused an unexpected change in the position of the operating system's file handle.

Текущий экземпляр потока не поддерживает запись.The current stream instance does not support writing.

Примеры

Данный пример кода является частью большего примера для Lock метод.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

Комментарии

Этот метод переопределяет метод Write.This method overrides Write.

offset Дает смещение байта в array (индекс буфера) с которого начинается копирование и count дает число байтов, которые будут записаны в поток.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. При успешном выполнении операции записи текущей позиции потока продвигается на число записанных байтов.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Если возникает исключение, текущее положение потока не меняется.If an exception occurs, the current position of the stream is unchanged.

Примечание

Используйте CanWrite свойства, чтобы определить, поддерживает ли текущий экземпляр операции записи.Use the CanWrite property to determine whether the current instance supports writing. Дополнительные сведения см. в разделе CanWrite.For additional information, see CanWrite.

Не прерывайте потоке, который выполняет операции записи.Do not interrupt a thread that is performing a write operation. Несмотря на то, что приложение может возникнуть, для успешного выполнения после поток не заблокирован, прерывания может привести к снижению производительности и надежности приложения.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Список общих файлов и операции с каталогами, см. в разделе распространенные задачи ввода-вывода.For a list of common file and directory operations, see Common I/O Tasks.

Дополнительно

Применяется к