StreamWriter クラス

.NET Framework クラス ライブラリ リファレンス

StreamWriter クラス

文字を特定のエンコーディングでストリームに書き込むための TextWriter を実装しています。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class StreamWriter
    Inherits TextWriter

Visual Basic (使用法)

Dim instance As StreamWriter

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class StreamWriter : TextWriter

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class StreamWriter : public
 TextWriter

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class StreamWriter extends TextWriter

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class StreamWriter extends
 TextWriter

解説

StreamWriter は、文字を特定のエンコーディングで出力するために使用します。一方、Stream の派生クラスは、バイトの入出力に使用します。

他に指定がない場合、StreamWriter は UTF8Encoding のインスタンスを使用するように既定で設定されます。この UTF8Encoding のインスタンスは、Encoding.GetPreamble メソッドが UTF-8 で書き込まれた Unicode バイト順マークを返すように構築されます。エンコーディングのプリアンブルは、既存のストリームに追加する場合を除き、ストリームに追加されます。つまり、StreamWriter で作成されたすべてのテキスト ファイルの先頭に、3 バイトのバイト順マークが含まれます。UTF-8 は、すべての Unicode 文字を正しく処理し、オペレーティング システムの各ローカライズ バージョンで一貫した結果を提供します。

既定では、StreamWriter はスレッドセーフではありません。スレッド セーフ ラッパーについては、TextWriter.Synchronized のトピックを参照してください。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする

継承階層

System.Object
   System.MarshalByRefObject
     System.IO.TextWriter
      System.IO.StreamWriter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
StreamWriter メンバ
System.IO 名前空間
Stream クラス
StreamReader クラス
Encoder
Encoding
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
基本のファイル I/O
方法 : 新しく作成されたデータ ファイルに対して読み書きする