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 内のバイト オフセット。インデックス番号は 0 から始まります。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.

例外

offsetcountarray の無効な範囲を示しています。offset and count describe an invalid range in array.

offset または count が負の値です。offset or count is negative.

I/O エラーが発生しました。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 stream is closed.

現在のストリームのインスタンスでは、書き込みをサポートしません。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.

一般的なファイルとディレクトリの操作の一覧は、次を参照してください。共通 I/O タスクします。For a list of common file and directory operations, see Common I/O Tasks.

こちらもご覧ください

適用対象