StreamWriter コンストラクター (Stream, Encoding) (System.IO)

StreamWriter コンストラクター (Stream, Enco...

すべて縮小

言語フィルタ

コンテンツの表示: 英語と日本語を並べて表示

.NET Framework Class Library

StreamWriter Constructor (Stream, Encoding)

Updated: December 2010

Initializes a new instance of the StreamWriter class for the specified stream, using the specified encoding and the default buffer size.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic

Public Sub New ( _
    stream As Stream, _
    encoding As Encoding _
)

public StreamWriter(
    Stream stream,
    Encoding encoding
)

Visual C++

public:
StreamWriter(
    Stream^ stream, 
    Encoding^ encoding
)

new : 
        stream:Stream * 
        encoding:Encoding -> StreamWriter

Parameters

stream: Type: System.IO..::.Stream
The stream to write to.

encoding: Type: System.Text..::.Encoding
The character encoding to use.

Exceptions

Exception	Condition
ArgumentNullException	stream or encoding is nullNothingnullptra null reference (Nothing in Visual Basic).
ArgumentException	stream is not writable.

Remarks

This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. The position of the stream is not reset. For additional information, see Encoding.

The StreamWriter object calls Dispose on the provided Stream object when StreamWriter..::.Dispose is called.

Caution
When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

For a list of common I/O tasks, see Common I/O Tasks.

Examples

The following example demonstrates the StreamWriter constructors.

Visual Basic

Public Sub CreateTextFile(ByVal FileName As String, _
    ByVal TextToAdd As String)

    Dim Fs As FileStream = New FileStream(FileName, _
        FileMode.CreateNew, FileAccess.Write, FileShare.None)

    Dim SwFromFile As StreamWriter = New StreamWriter(FileName)
    SwFromFile.Write(TextToAdd)
    SwFromFile.Flush()
    SwFromFile.Close()

    Dim SwFromFileStream As StreamWriter = New StreamWriter(Fs)
    SwFromFileStream.Write(TextToAdd)
    SwFromFileStream.Flush()
    SwFromFileStream.Close()

    Dim SwFromFileStreamDefaultEnc As StreamWriter = _
     New StreamWriter(Fs, System.Text.Encoding.Default)
    SwFromFileStreamDefaultEnc.Write(TextToAdd)
    SwFromFileStreamDefaultEnc.Flush()
    SwFromFileStreamDefaultEnc.Close()

    Dim SwFromFileTrue As StreamWriter = _
     New StreamWriter(FileName, True)
    SwFromFileTrue.Write(TextToAdd)
    SwFromFileTrue.Flush()
    SwFromFileTrue.Close()

    Dim SwFromFileTrueUTF8Buffer = _
     New StreamWriter(FileName, _
     True, System.Text.Encoding.UTF8, 512)
    SwFromFileTrueUTF8Buffer.Write(TextToAdd)
    SwFromFileTrueUTF8Buffer.Flush()
    SwFromFileTrueUTF8Buffer.Close()

    Dim SwFromFileTrueUTF8 = _
     New StreamWriter(FileName, True, _
     System.Text.Encoding.UTF8)
    SwFromFileTrueUTF8.Write(TextToAdd)
    SwFromFileTrueUTF8.Flush()
    SwFromFileTrueUTF8.Close()

    Dim SwFromFileStreamUTF8Buffer = _
     New StreamWriter(Fs, System.Text.Encoding.UTF8, 512)
    SwFromFileStreamUTF8Buffer.Write(textToAdd)
    SwFromFileStreamUTF8Buffer.Flush()
    SwFromFileStreamUTF8Buffer.Close()

End Sub

        public void CreateTextFile(string fileName, string textToAdd) 
        {
            string logFile = DateTime.Now.ToShortDateString()
                .Replace(@"/",@"-").Replace(@"\",@"-") + ".log";
            
            FileStream fs = new FileStream(fileName,
                FileMode.CreateNew, FileAccess.Write, FileShare.None);
            
            StreamWriter swFromFile = new StreamWriter(logFile);
            swFromFile.Write(textToAdd);
            swFromFile.Flush();
            swFromFile.Close();

            StreamWriter swFromFileStream = new StreamWriter(fs);
            swFromFileStream.Write(textToAdd);
            swFromFileStream.Flush();
            swFromFileStream.Close();

            StreamWriter swFromFileStreamDefaultEnc = 
                new System.IO.StreamWriter(fs, 
                System.Text.Encoding.Default);
            swFromFileStreamDefaultEnc.Write(textToAdd);
            swFromFileStreamDefaultEnc.Flush();
            swFromFileStreamDefaultEnc.Close();

            StreamWriter swFromFileTrue = 
                new StreamWriter(fileName,true);
            swFromFileTrue.Write(textToAdd);
            swFromFileTrue.Flush();
            swFromFileTrue.Close();
            
            StreamWriter swFromFileTrueUTF8Buffer = 
                new StreamWriter(fileName, 
                true, System.Text.Encoding.UTF8,512);
            swFromFileTrueUTF8Buffer.Write(textToAdd);
            swFromFileTrueUTF8Buffer.Flush();
            swFromFileTrueUTF8Buffer.Close();

            StreamWriter swFromFileTrueUTF8 = 
                new StreamWriter(fileName, true,
                System.Text.Encoding.UTF8);
            swFromFileTrueUTF8.Write(textToAdd);
            swFromFileTrueUTF8.Flush();
            swFromFileTrueUTF8.Close();

            StreamWriter swFromFileStreamUTF8Buffer = 
                new StreamWriter(fs, System.Text.Encoding.UTF8, 512);
            swFromFileStreamUTF8Buffer.Write(textToAdd);
            swFromFileStreamUTF8Buffer.Flush();
            swFromFileStreamUTF8Buffer.Close();
        }

Visual C++

void CreateTextFile( String^ fileName, String^ textToAdd )
{
   String^ logFile = String::Concat( DateTime::Now.ToShortDateString()
      ->Replace( "/", "-" )->Replace( "\\", "-" ), ".log" );

   FileStream^ fs = gcnew FileStream( fileName,
      FileMode::CreateNew, FileAccess::Write, FileShare::None );

   StreamWriter^ swFromFile = gcnew StreamWriter( logFile );
   swFromFile->Write( textToAdd );
   swFromFile->Flush();
   swFromFile->Close();

   StreamWriter^ swFromFileStream = gcnew StreamWriter( fs );
   swFromFileStream->Write( textToAdd );
   swFromFileStream->Flush();
   swFromFileStream->Close();

   StreamWriter^ swFromFileStreamDefaultEnc =
      gcnew System::IO::StreamWriter( fs,
         System::Text::Encoding::Default );
   swFromFileStreamDefaultEnc->Write( textToAdd );
   swFromFileStreamDefaultEnc->Flush();
   swFromFileStreamDefaultEnc->Close();

   StreamWriter^ swFromFileTrue =
      gcnew StreamWriter( fileName,true );
   swFromFileTrue->Write( textToAdd );
   swFromFileTrue->Flush();
   swFromFileTrue->Close();

   StreamWriter^ swFromFileTrueUTF8Buffer =
      gcnew StreamWriter( fileName,
         true, System::Text::Encoding::UTF8, 512 );
   swFromFileTrueUTF8Buffer->Write( textToAdd );
   swFromFileTrueUTF8Buffer->Flush();
   swFromFileTrueUTF8Buffer->Close();

   StreamWriter^ swFromFileTrueUTF8 =
      gcnew StreamWriter( fileName, true,
         System::Text::Encoding::UTF8 );
   swFromFileTrueUTF8->Write( textToAdd );
   swFromFileTrueUTF8->Flush();
   swFromFileTrueUTF8->Close();

   StreamWriter^ swFromFileStreamUTF8Buffer =
      gcnew StreamWriter( fs, System::Text::Encoding::UTF8, 512 );
   swFromFileStreamUTF8Buffer->Write( textToAdd );
   swFromFileStreamUTF8Buffer->Flush();
   swFromFileStreamUTF8Buffer->Close();
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

StreamWriter Class

StreamWriter Overload

System.IO Namespace

Encoding

Other Resources

File and Stream I/O

How to: Read Text from a File

How to: Write Text to a File

Change History

Date

History

Reason

December 2010

Added information about Dispose.

Information enhancement.

.NET Framework クラスライブラリ

StreamWriter コンストラクター (Stream, Encoding)

更新 : 2010 年 12 月

指定したエンコーディングと既定のバッファーサイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

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

構文

Visual Basic

Public Sub New ( _
    stream As Stream, _
    encoding As Encoding _
)

public StreamWriter(
    Stream stream,
    Encoding encoding
)

Visual C++

public:
StreamWriter(
    Stream^ stream, 
    Encoding^ encoding
)

new : 
        stream:Stream * 
        encoding:Encoding -> StreamWriter

パラメーター

stream: 型: System.IO..::.Stream
書き込まれるストリーム。

encoding: 型: System.Text..::.Encoding
使用する文字エンコーディング。

例外

例外	条件
ArgumentNullException	stream または encoding が nullNothingnullptrnull 参照 (Visual Basic では Nothing) です。
ArgumentException	stream が書き込み可能ではありません。

解説

このコンストラクターは、エンコーディングパラメーターを使用して Encoding プロパティを初期化し、ストリームパラメーターを使用して BaseStream プロパティを初期化します。ストリームの位置はリセットされません。詳細については、「Encoding」を参照してください。

StreamWriter..::.Dispose が呼び出されると、StreamWriter オブジェクトは、提供される Stream オブジェクトに対して Dispose を呼び出します。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

共通 I/O タスクの一覧については、「共通 I/O タスク」を参照してください。

例

StreamWriter コンストラクターの例を次に示します。

Visual Basic

Public Sub CreateTextFile(ByVal FileName As String, _
    ByVal TextToAdd As String)

    Dim Fs As FileStream = New FileStream(FileName, _
        FileMode.CreateNew, FileAccess.Write, FileShare.None)

    Dim SwFromFile As StreamWriter = New StreamWriter(FileName)
    SwFromFile.Write(TextToAdd)
    SwFromFile.Flush()
    SwFromFile.Close()

    Dim SwFromFileStream As StreamWriter = New StreamWriter(Fs)
    SwFromFileStream.Write(TextToAdd)
    SwFromFileStream.Flush()
    SwFromFileStream.Close()

    Dim SwFromFileStreamDefaultEnc As StreamWriter = _
     New StreamWriter(Fs, System.Text.Encoding.Default)
    SwFromFileStreamDefaultEnc.Write(TextToAdd)
    SwFromFileStreamDefaultEnc.Flush()
    SwFromFileStreamDefaultEnc.Close()

    Dim SwFromFileTrue As StreamWriter = _
     New StreamWriter(FileName, True)
    SwFromFileTrue.Write(TextToAdd)
    SwFromFileTrue.Flush()
    SwFromFileTrue.Close()

    Dim SwFromFileTrueUTF8Buffer = _
     New StreamWriter(FileName, _
     True, System.Text.Encoding.UTF8, 512)
    SwFromFileTrueUTF8Buffer.Write(TextToAdd)
    SwFromFileTrueUTF8Buffer.Flush()
    SwFromFileTrueUTF8Buffer.Close()

    Dim SwFromFileTrueUTF8 = _
     New StreamWriter(FileName, True, _
     System.Text.Encoding.UTF8)
    SwFromFileTrueUTF8.Write(TextToAdd)
    SwFromFileTrueUTF8.Flush()
    SwFromFileTrueUTF8.Close()

    Dim SwFromFileStreamUTF8Buffer = _
     New StreamWriter(Fs, System.Text.Encoding.UTF8, 512)
    SwFromFileStreamUTF8Buffer.Write(textToAdd)
    SwFromFileStreamUTF8Buffer.Flush()
    SwFromFileStreamUTF8Buffer.Close()

End Sub

        public void CreateTextFile(string fileName, string textToAdd) 
        {
            string logFile = DateTime.Now.ToShortDateString()
                .Replace(@"/",@"-").Replace(@"\",@"-") + ".log";
            
            FileStream fs = new FileStream(fileName,
                FileMode.CreateNew, FileAccess.Write, FileShare.None);
            
            StreamWriter swFromFile = new StreamWriter(logFile);
            swFromFile.Write(textToAdd);
            swFromFile.Flush();
            swFromFile.Close();

            StreamWriter swFromFileStream = new StreamWriter(fs);
            swFromFileStream.Write(textToAdd);
            swFromFileStream.Flush();
            swFromFileStream.Close();

            StreamWriter swFromFileStreamDefaultEnc = 
                new System.IO.StreamWriter(fs, 
                System.Text.Encoding.Default);
            swFromFileStreamDefaultEnc.Write(textToAdd);
            swFromFileStreamDefaultEnc.Flush();
            swFromFileStreamDefaultEnc.Close();

            StreamWriter swFromFileTrue = 
                new StreamWriter(fileName,true);
            swFromFileTrue.Write(textToAdd);
            swFromFileTrue.Flush();
            swFromFileTrue.Close();
            
            StreamWriter swFromFileTrueUTF8Buffer = 
                new StreamWriter(fileName, 
                true, System.Text.Encoding.UTF8,512);
            swFromFileTrueUTF8Buffer.Write(textToAdd);
            swFromFileTrueUTF8Buffer.Flush();
            swFromFileTrueUTF8Buffer.Close();

            StreamWriter swFromFileTrueUTF8 = 
                new StreamWriter(fileName, true,
                System.Text.Encoding.UTF8);
            swFromFileTrueUTF8.Write(textToAdd);
            swFromFileTrueUTF8.Flush();
            swFromFileTrueUTF8.Close();

            StreamWriter swFromFileStreamUTF8Buffer = 
                new StreamWriter(fs, System.Text.Encoding.UTF8, 512);
            swFromFileStreamUTF8Buffer.Write(textToAdd);
            swFromFileStreamUTF8Buffer.Flush();
            swFromFileStreamUTF8Buffer.Close();
        }

Visual C++

void CreateTextFile( String^ fileName, String^ textToAdd )
{
   String^ logFile = String::Concat( DateTime::Now.ToShortDateString()
      ->Replace( "/", "-" )->Replace( "\\", "-" ), ".log" );

   FileStream^ fs = gcnew FileStream( fileName,
      FileMode::CreateNew, FileAccess::Write, FileShare::None );

   StreamWriter^ swFromFile = gcnew StreamWriter( logFile );
   swFromFile->Write( textToAdd );
   swFromFile->Flush();
   swFromFile->Close();

   StreamWriter^ swFromFileStream = gcnew StreamWriter( fs );
   swFromFileStream->Write( textToAdd );
   swFromFileStream->Flush();
   swFromFileStream->Close();

   StreamWriter^ swFromFileStreamDefaultEnc =
      gcnew System::IO::StreamWriter( fs,
         System::Text::Encoding::Default );
   swFromFileStreamDefaultEnc->Write( textToAdd );
   swFromFileStreamDefaultEnc->Flush();
   swFromFileStreamDefaultEnc->Close();

   StreamWriter^ swFromFileTrue =
      gcnew StreamWriter( fileName,true );
   swFromFileTrue->Write( textToAdd );
   swFromFileTrue->Flush();
   swFromFileTrue->Close();

   StreamWriter^ swFromFileTrueUTF8Buffer =
      gcnew StreamWriter( fileName,
         true, System::Text::Encoding::UTF8, 512 );
   swFromFileTrueUTF8Buffer->Write( textToAdd );
   swFromFileTrueUTF8Buffer->Flush();
   swFromFileTrueUTF8Buffer->Close();

   StreamWriter^ swFromFileTrueUTF8 =
      gcnew StreamWriter( fileName, true,
         System::Text::Encoding::UTF8 );
   swFromFileTrueUTF8->Write( textToAdd );
   swFromFileTrueUTF8->Flush();
   swFromFileTrueUTF8->Close();

   StreamWriter^ swFromFileStreamUTF8Buffer =
      gcnew StreamWriter( fs, System::Text::Encoding::UTF8, 512 );
   swFromFileStreamUTF8Buffer->Write( textToAdd );
   swFromFileStreamUTF8Buffer->Flush();
   swFromFileStreamUTF8Buffer->Close();
}

バージョン情報

.NET Framework

サポート対象: 4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

サポート対象: 4、3.5 SP1

サポート対象:

プラットフォーム

Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

参照