エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StreamWriter クラス

2013/12/12

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

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

Namespace:  System.IO
アセンブリ:  mscorlib (mscorlib.dll 内)

public class StreamWriter : TextWriter

StreamWriter 型で公開されるメンバーは以下のとおりです。

  名前説明
パブリック メソッドStreamWriter(Stream)UTF-8 エンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。
パブリック メソッドStreamWriter(String)既定のエンコーディングとバッファー サイズを使用して、指定されたパス上の指定されたファイル用の StreamWriter クラスの新しいインスタンスを初期化します。
パブリック メソッドStreamWriter(Stream, Encoding)指定したエンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。
パブリック メソッドStreamWriter(String, Boolean)既定のエンコーディングとバッファー サイズを使用して、指定されたパス上の指定されたファイル用の StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。
パブリック メソッドStreamWriter(Stream, Encoding, Int32)指定したエンコーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。
パブリック メソッドStreamWriter(String, Boolean, Encoding)指定したエンコーディングと既定のバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。
パブリック メソッドStreamWriter(Stream, Encoding, Int32, Boolean)StreamWriter クラスの新しいインスタンスが、指定されたエンコーディング、バッファー サイズ、およびストリームを開いたままに維持するかどうかを指定する値を使用して、指定されたストリームに対して初期化されます。
パブリック メソッドStreamWriter(String, Boolean, Encoding, Int32)指定したエンコーディングとバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。
このページのトップへ

  名前説明
パブリック プロパティAutoFlushStreamWriter.Write が呼び出されるたびに、StreamWriter によって基になるストリームに対するバッファーをフラッシュするかどうかを示す値を取得または設定します。
パブリック プロパティBaseStreamバッキング ストアと連結する、基になるストリームを取得します。
パブリック プロパティEncoding出力の書き込みに使用する Encoding を取得します。 (TextWriter.Encoding をオーバーライドします。)
パブリック プロパティFormatProvider書式を制御するオブジェクトを取得します。 (TextWriter から継承されます。)
パブリック プロパティNewLine現在の TextWriter で使用される行終端文字列を取得または設定します。 (TextWriter から継承されます。)
このページのトップへ

  名前説明
パブリック メソッドClose現在の StreamWriter オブジェクトと基になるストリームを閉じます。 (TextWriter.Close() をオーバーライドします。)
パブリック メソッドDispose()この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。 (TextWriter から継承されます。)
プロテクト メソッドDispose(Boolean)StreamWriter によって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。 (TextWriter.Dispose(Boolean) をオーバーライドします。)
パブリック メソッドEquals(Object)指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。)
プロテクト メソッドFinalizeObject がガベージ コレクションで再利用される前に、Object がリソースを解放して他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッドFlush現在のライターで使用したすべてのバッファーをクリアし、バッファー内のすべてのデータを基になるストリームに書き込みます。 (TextWriter.Flush() をオーバーライドします。)
パブリック メソッドFlushAsyncこのストリームに対応するすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (TextWriter.FlushAsync() をオーバーライドします。)
パブリック メソッドGetHashCode特定の型のハッシュ関数として機能します。 (Object から継承されます。)
パブリック メソッドGetType現在のインスタンスの Type を取得します。 (Object から継承されます。)
プロテクト メソッドMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
パブリック メソッドToString現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
パブリック メソッドWrite(Boolean)Boolean 値のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Char)ストリームに文字を書き込みます。 (TextWriter.Write(Char) をオーバーライドします。)
パブリック メソッドWrite(Char[])ストリームに文字配列を書き込みます。 (TextWriter.Write(Char[]) をオーバーライドします。)
パブリック メソッドWrite(Decimal)10 進値のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Double)8 バイト浮動小数点値のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Int32)4 バイト符号付き整数のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Int64)8 バイト符号付き整数のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Object)オブジェクトのテキスト形式を、そのオブジェクト上で ToString を呼び出すことにより、テキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Single)4 バイト浮動小数点値のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(String)ストリームに文字列を書き込みます。 (TextWriter.Write(String) をオーバーライドします。)
パブリック メソッドWrite(UInt32)4 バイト符号なし整数のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(UInt64)8 バイト符号なし整数のテキスト形式をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(String, Object)String.Format と同じセマンティクスを使用して、書式設定された文字列を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(String, Object[])String.Format と同じセマンティクスを使用して、書式設定された文字列を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWrite(Char[], Int32, Int32)ストリームに文字配列の一部を書き込みます。 (TextWriter.Write(Char[], Int32, Int32) をオーバーライドします。)
パブリック メソッドWrite(String, Object, Object)String.Format と同じセマンティクスを使用して、書式設定された文字列を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteAsync(Char)ストリームに文字を非同期的に書き込みます。 (TextWriter.WriteAsync(Char) をオーバーライドします。)
パブリック メソッドWriteAsync(Char[])文字配列をテキスト文字列またはストリームに非同期的に書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteAsync(String)ストリームに文字列を非同期的に書き込みます。 (TextWriter.WriteAsync(String) をオーバーライドします。)
パブリック メソッドWriteAsync(Char[], Int32, Int32)ストリームに文字配列の一部を非同期的に書き込みます。 (TextWriter.WriteAsync(Char[], Int32, Int32) をオーバーライドします。)
パブリック メソッドWriteLine()行終端記号をテキスト ストリームに書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Boolean)Boolean 値のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Char)文字をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Char[])文字の配列をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Decimal)10 進値のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Double)8 バイト浮動小数点値のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Int32)4 バイト符号付き整数のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Int64)8 バイト符号付き整数のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Object)オブジェクトのテキスト形式を、このオブジェクト上で ToString を呼び出すことにより、テキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Single)4 バイト浮動小数点値のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(String)文字列をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(UInt32)4 バイト符号なし整数のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(UInt64)8 バイト符号なし整数のテキスト形式をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(String, Object)Format と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(String, Object[])Format と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(Char[], Int32, Int32)文字のサブ配列をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLine(String, Object, Object)Format と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLineAsync()行終端記号をストリームに非同期的に書き込みます。 (TextWriter.WriteLineAsync() をオーバーライドします。)
パブリック メソッドWriteLineAsync(Char)文字をストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (TextWriter.WriteLineAsync(Char) をオーバーライドします。)
パブリック メソッドWriteLineAsync(Char[])文字の配列をテキスト文字列またはストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (TextWriter から継承されます。)
パブリック メソッドWriteLineAsync(String)文字列をストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (TextWriter.WriteLineAsync(String) をオーバーライドします。)
パブリック メソッドWriteLineAsync(Char[], Int32, Int32)文字のサブ配列をストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (TextWriter.WriteLineAsync(Char[], Int32, Int32) をオーバーライドします。)
このページのトップへ

  名前説明
プロテクト フィールドCoreNewLineこの TextWriter に使用される改行文字を格納します。 (TextWriter から継承されます。)
パブリック フィールド静的メンバーNull書き込みは可能でも読み取りが不可能なバッキング ストアを持たない StreamWriter を提供します。
このページのトップへ

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

他に指定がない場合、StreamWriterUTF8Encoding のインスタンスを使用するように既定で設定されます。UTF8Encoding のこのインスタンスは、バイト順マーク (BOM) を使用せずに作成されるため、GetPreamble メソッドは空のバイト配列を返します。UTF-8 エンコーディングと BOM を使用して StreamWriter を作成するには、StreamWriter(String, Boolean, Encoding) などのエンコーディングを指定するコンストラクターを使用することを検討してください。

既定では、StreamWriter はスレッド セーフではありません。

次の例では、StreamWriter を使用して、ユーザーの [マイ ドキュメント] フォルダー内のファイルにテキスト ボックス コントロール (inputData と呼ばれる) の内容を保存しています。分離ストレージ ファイルの内容を読み取る方法の例については、StreamReader クラスのトピックを参照してください。


private void SaveFile_Click(object sender, RoutedEventArgs e)
{
	// fileLoc is a global string variable, set in StreamReader example.
	using (StreamWriter sw = new StreamWriter(fileLoc, false))
	{
		sw.WriteLine(inputData.Text);
		inputData.Text = "";
		inputData.Visibility = Visibility.Collapsed;
	}
	
}


Windows Phone OS

サポート: 8.0, 7.1, 7.0

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

表示:
© 2014 Microsoft