現在のストリームに文字配列の特定の領域を書き込み、使用した Encoding とストリームに書き込んだ特定の文字に従ってストリームの現在位置を進めます。
Overloads Public Overridable Sub Write( _
ByVal chars() As Char, _ ByVal index As Integer, _ ByVal count As Integer _)
[C#]
public virtual void Write(char[] chars,intindex,intcount);
[C++]
public: virtual void Write(__wchar_tchars __gc[],intindex,intcount);
[JScript]
public function Write(
chars : Char[],index : int,count : int);
パラメータ
- chars
書き込むデータを格納する文字配列。 - index
buffer 内の書き込み開始点。 - count
書き込む文字の数。
例外
例外の種類 | 条件 |
---|---|
ArgumentException | バッファ長から index を差し引いた値が count より小さい値です。 |
ArgumentNullException | chars が null 参照 (Visual Basic では Nothing) です。 |
ArgumentOutOfRangeException | index または count が負の値です。 |
IOException | I/O エラーが発生しました。 |
ObjectDisposedException | ストリームが閉じられました。 |
解説
その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
実行するタスク | 参考例があるトピック |
---|---|
テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
テキストをファイルに追加する。 | ログ ファイルのオープンと追加 |
ファイルのサイズを取得する。 | FileInfo.Length |
ファイルの属性を取得する。 | File.GetAttributes |
ファイルの属性を設定する。 | File.SetAttributes |
ファイルが存在するかどうかを判別する。 | File.Exists |
バイナリ ファイルから読み取る。 | 新しく作成したデータ ファイルの読み取りと書き込み |
バイナリ ファイルに書き込む。 | 新しく作成したデータ ファイルの読み取りと書き込み |
使用例
[Visual Basic, C#, C++] メモリをバッキング ストアとして使用してデータを読み書きする方法の例を次に示します。
Imports System
Imports System.IO
Public Class BinaryRW
Shared Sub Main()
Dim invalidPathChars() As Char = Path.InvalidPathChars
Dim memStream As new MemoryStream()
Dim binWriter As New BinaryWriter(memStream)
' Write to memory.
binWriter.Write("Invalid file path characters are: ")
binWriter.Write(Path.InvalidPathChars, 0, _
Path.InvalidPathChars.Length)
' Create the reader using the same MemoryStream
' as used with the writer.
Dim binReader As New BinaryReader(memStream)
' Set Position to the beginning of the stream.
memStream.Position = 0
' Read the data from memory and write it to the console.
Console.Write(binReader.ReadString())
Dim upperBound As Integer = _
CInt(memStream.Length - memStream.Position) - 1
Dim memoryData(upperBound) As Char
binReader.Read(memoryData, 0, upperBound)
Console.WriteLine(memoryData)
End Sub
End Class
[C#]
using System;
using System.IO;
class BinaryRW
{
static void Main()
{
char[] invalidPathChars = Path.InvalidPathChars;
MemoryStream memStream = new MemoryStream();
BinaryWriter binWriter = new BinaryWriter(memStream);
// Write to memory.
binWriter.Write("Invalid file path characters are: ");
binWriter.Write(
Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
// Create the reader using the same MemoryStream
// as used with the writer.
BinaryReader binReader = new BinaryReader(memStream);
// Set Position to the beginning of the stream.
memStream.Position = 0;
// Read the data from memory and write it to the console.
Console.Write(binReader.ReadString());
int arraySize = (int)(memStream.Length - memStream.Position);
char[] memoryData = new char[arraySize];
binReader.Read(memoryData, 0, arraySize);
Console.WriteLine(memoryData);
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace System::IO;
void main()
{
Char invalidPathChars __gc[] = Path::InvalidPathChars;
MemoryStream* memStream = new MemoryStream();
BinaryWriter* binWriter = new BinaryWriter(memStream);
// Write to memory.
binWriter->Write(S"Invalid file path characters are: ");
binWriter->Write(
Path::InvalidPathChars, 0, Path::InvalidPathChars->Length);
// Create the reader using the same MemoryStream
// as used with the writer.
BinaryReader* binReader = new BinaryReader(memStream);
// Set Position to the beginning of the stream.
binReader->BaseStream->Position = 0;
// Read the data from memory and write it to the console.
Console::Write(binReader->ReadString());
int arraySize = (int)(memStream->Length - memStream->Position);
Char memoryData __gc[] = new Char __gc[arraySize];
binReader->Read(memoryData, 0, arraySize);
Console::WriteLine(memoryData);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
BinaryWriter クラス | BinaryWriter メンバ | System.IO 名前空間 | BinaryWriter.Write オーバーロードの一覧 | Encoding | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み