TextWriterとは何？わかりやすく解説 Weblio辞書

.NET Framework用語集

索引トップ用語の索引ランキング

テキストライタ [text writer]

ASP.NET モバイルコントロールでは、デバイスアダプタがオブジェクトを介して出力を書き込むことができるようにする機構。テキストライタオブジェクトは、TextWriter 基本クラスから作成されます。参照 : デバイスアダプタ

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

索引トップ用語の索引ランキング

TextWriter クラス

一連の文字を書き込むことができるライタを表します。このクラスは抽象クラスです。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public MustInherit Class
 TextWriter
    Inherits MarshalByRefObject
    Implements IDisposable

Visual Basic (使用法)

Dim instance As TextWriter

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public abstract class TextWriter : MarshalByRefObject,
 IDisposable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class TextWriter abstract : public
 MarshalByRefObject, IDisposable

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public abstract class TextWriter extends MarshalByRefObject
 implements IDisposable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public abstract class TextWriter extends
 MarshalByRefObject implements IDisposable

解説

TextWriter は、ストリームと文字列に文字を書き込む StreamWriter および StringWriter の抽象基本クラスです。オブジェクトを文字列に書き込む、文字列をファイルに書き込む、または、XML のシリアル化を行うには、TextWriter のインスタンスを作成します。また、TextWriter を使用すると、文字列またはストリームに対して使用するものと同一の API でカスタムバッキングストアにテキストを書き込むことができます。また、テキストに対する書式設定のサポートを追加することもできます。

パラメータとしてプリミティブデータ型を持っている TextWriter の Write メソッドはすべて、文字列として値を書き込みます。

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

TextWriter クラスの有用なインスタンスを作成するには、派生クラスで少なくとも Write メソッドを実装する必要があります。

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

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

使用例

TextReader タイプと TextWriter タイプのポリモーフィックな動作の例を次に示します。aStringWriter と aStreamWriter は両方とも TextWriter タイプであるため、両方のオブジェクトで WriteVowel メソッドが呼び出され、それぞれのタイプに関連付けられた Write メソッドが実行されます。同様に、aStringReader と aStreamReader の両方で ReadText メソッドが呼び出され、正しい ReadToEnd メソッドが実行されます。aStringWriter および aStringReader のバッキングストアは文字列であり、aStreamWriter および aStreamReader のバッキングストアはファイルです。

Visual Basic

Imports System
Imports System.IO

Public Class TextRW

    Shared Sub Main()
        Dim aStringWriter, aStreamWriter As
 TextWriter
        aStringWriter = New StringWriter()
        aStreamWriter = New StreamWriter("InvalidPathChars.txt")
        
        WriteText(aStringWriter)
        WriteText(aStreamWriter)
        aStreamWriter.Close()
        
        Dim aStringReader, aStreamReader As
 TextReader
        aStringReader = New StringReader(aStringWriter.ToString())
        aStreamReader = New StreamReader("InvalidPathChars.txt")
        
        ReadText(aStringReader)
        ReadText(aStreamReader)
        aStreamReader.Close()
    End Sub

    Shared Sub WriteText(aTextWriter As
 TextWriter)
        aTextWriter.Write("Invalid file path characters are: ")
        aTextWriter.Write(Path.InvalidPathChars)
        aTextWriter.Write("."C)
    End Sub

    Shared Sub ReadText(aTextReader As
 TextReader)
        Console.WriteLine("From {0} - {1}", _
            aTextReader.GetType().Name, aTextReader.ReadToEnd())
    End Sub

End Class

using System;
using System.IO;

class TextRW
{
    static void Main()
    {
        TextWriter stringWriter = new StringWriter();
        using(TextWriter streamWriter = 
            new StreamWriter("InvalidPathChars.txt"))
        {
            WriteText(stringWriter);
            WriteText(streamWriter);
        }

        TextReader stringReader = 
            new StringReader(stringWriter.ToString());
        using(TextReader streamReader = 
            new StreamReader("InvalidPathChars.txt"))
        {
            ReadText(stringReader);
            ReadText(streamReader);
        }
    }

    static void WriteText(TextWriter textWriter)
    {
        textWriter.Write("Invalid file path characters are: ");
        textWriter.Write(Path.InvalidPathChars);
        textWriter.Write('.');
    }

    static void ReadText(TextReader textReader)
    {
        Console.WriteLine("From {0} - {1}", 
            textReader.GetType().Name, textReader.ReadToEnd());
    }
}

C++

using namespace System;
using namespace System::IO;

void WriteText( TextWriter^ textWriter )
{
   textWriter->Write(  "Invalid file path characters are: " );
   textWriter->Write( Path::InvalidPathChars );
   textWriter->Write( Char::Parse( "." ) );
}


void ReadText( TextReader^ textReader )
{
   Console::WriteLine( "From {0} - {1}", textReader->GetType()->Name,
 textReader->ReadToEnd() );
}


int main()
{
   
   TextWriter^ stringWriter = gcnew StringWriter;
   TextWriter^ streamWriter = gcnew StreamWriter(  "InvalidPathChars.txt"
 );
   
   WriteText( stringWriter );
   WriteText( streamWriter );
   streamWriter->Close();
   
   TextReader^ stringReader = gcnew StringReader( stringWriter->ToString() );
   TextReader^ streamReader = gcnew StreamReader(  "InvalidPathChars.txt"
 );
   
   ReadText( stringReader );
   ReadText( streamReader );
   streamReader->Close();
}

import System.*;
import System.IO.*;

class TextRW
{
    public static void main(String[]
 args)
    {
        TextWriter stringWriter = new StringWriter();
        TextWriter streamWriter = new StreamWriter("InvalidPathChars.txt");
        try {
            WriteText(stringWriter);
            WriteText(streamWriter);
        }
        finally {
            streamWriter.Dispose();
        }
        TextReader stringReader = new StringReader(stringWriter.ToString());
        TextReader streamReader = new StreamReader("InvalidPathChars.txt");
        try {
            ReadText(stringReader);
            ReadText(streamReader);
        }
        finally {
            streamReader.Dispose();
        }        
    } //main

    static void WriteText(TextWriter textWriter)
    {
        textWriter.Write("Invalid file path characters are: ");
        textWriter.Write(Path.InvalidPathChars);
        textWriter.Write('.');
    } //WriteText

    static void ReadText(TextReader textReader)
 
    {
        Console.WriteLine("From {0} - {1}", 
            textReader.GetType().get_Name(),textReader.ReadToEnd());
    } //ReadText
} //TextRW

継承階層

System.Object
   System.MarshalByRefObject
    System.IO.TextWriter
       System.CodeDom.Compiler.IndentedTextWriter
       System.IO.StreamWriter
       System.IO.StringWriter
       System.Web.HttpWriter
       System.Web.UI.HtmlTextWriter

スレッドセーフ

この型の 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

参照

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

TextWriter コンストラクタ ()

TextWriter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New TextWriter

protected TextWriter ()

C++

protected:
TextWriter ()

protected TextWriter ()

JScript

protected function TextWriter ()

解説

派生クラスでは、このコンストラクタを使用します。

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

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

使用例

このコード例は、TextWriter クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Dim aStringWriter, aStreamWriter As TextWriter
aStringWriter = New StringWriter()
aStreamWriter = New StreamWriter("InvalidPathChars.txt")

TextWriter stringWriter = new StringWriter();
using(TextWriter streamWriter = 
    new StreamWriter("InvalidPathChars.txt"))

C++

TextWriter^ stringWriter = gcnew StringWriter;
TextWriter^ streamWriter = gcnew StreamWriter(  "InvalidPathChars.txt"
 );

TextWriter stringWriter = new StringWriter();
TextWriter streamWriter = new StreamWriter("InvalidPathChars.txt");

プラットフォーム

バージョン情報

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

参照

関連項目
TextWriter クラス
TextWriter メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

TextWriter コンストラクタ (IFormatProvider)

指定した書式プロバイダで TextWriter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    formatProvider As IFormatProvider _
)

Visual Basic (使用法)

Dim formatProvider As IFormatProvider

Dim instance As New TextWriter(formatProvider)

protected TextWriter (
    IFormatProvider formatProvider
)

C++

protected:
TextWriter (
    IFormatProvider^ formatProvider
)

protected TextWriter (
    IFormatProvider formatProvider
)

JScript

protected function TextWriter (
    formatProvider : IFormatProvider
)

パラメータ

formatProvider: 書式を制御する IFormatProvider オブジェクト。

解説

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

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

プラットフォーム

バージョン情報

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

参照

TextWriter コンストラクタ

TextWriter クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
TextWriter ()	TextWriter クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
TextWriter (IFormatProvider)	指定した書式プロバイダで TextWriter クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

TextWriter フィールド

パブリックフィールドパブリックフィールド

( プロテクトフィールドも参照)

	名前	説明
	Null	バッキングストアを持たない書き込み専用の TextWriter を提供します。

プロテクトフィールド

	名前	説明
	CoreNewLine	TextWriter で使用する改行文字を格納します。

参照

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
基本のファイル I/O
方法 : 新しく作成されたデータファイルに対して読み書きする

TextWriter プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	NewLine	現在の TextWriter で使用される行終端文字列を取得または設定します。

参照

その他の技術情報

TextWriter メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Close	現在のライタを終了し、ライタに関連付けられたすべてのシステムリソースを解放します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	現在のライタのすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Synchronized	指定した TextWriter をラップするスレッドセーフラッパーを作成します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Write	オーバーロードされます。指定したデータ型をテキストストリームに書き込みます。
	WriteLine	オーバーロードされます。オーバーロードされたパラメータが指定するデータを書き込み、続けて行終端記号を書き込みます。

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose

参照

その他の技術情報

TextWriter メンバ

一連の文字を書き込むことができるライタを表します。このクラスは抽象クラスです。

TextWriter データ型で公開されるメンバを以下の表に示します。

プロテクトコンストラクタ

	名前	説明
	TextWriter	オーバーロードされます。 TextWriter クラスの新しいインスタンスを初期化します。

パブリックフィールド

( プロテクトフィールドも参照)

	名前	説明
	Null	バッキングストアを持たない書き込み専用の TextWriter を提供します。

プロテクトフィールド

	名前	説明
	CoreNewLine	TextWriter で使用する改行文字を格納します。

パブリックプロパティ

	名前	説明
	NewLine	現在の TextWriter で使用される行終端文字列を取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Close	現在のライタを終了し、ライタに関連付けられたすべてのシステムリソースを解放します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	現在のライタのすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Synchronized	指定した TextWriter をラップするスレッドセーフラッパーを作成します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Write	オーバーロードされます。指定したデータ型をテキストストリームに書き込みます。
	WriteLine	オーバーロードされます。オーバーロードされたパラメータが指定するデータを書き込み、続けて行終端記号を書き込みます。

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose

参照

その他の技術情報

>> 「TextWriter」を含む用語の索引
TextWriterのページへのリンク

TextWriterとは？わかりやすく解説

テキストライタ [text writer]

TextWriter クラス

TextWriter コンストラクタ ()

TextWriter コンストラクタ (IFormatProvider)

TextWriter コンストラクタ

関連項目

その他の技術情報

TextWriter フィールド

関連項目

その他の技術情報

TextWriter プロパティ

関連項目

その他の技術情報

TextWriter メソッド

関連項目

その他の技術情報

TextWriter メンバ

関連項目

その他の技術情報

「TextWriter」の関連用語


	© 2024 Microsoft.All rights reserved.
	© 2024 Microsoft.All rights reserved.

TextWriterとは？ わかりやすく解説

テキスト ライタ [text writer]

TextWriter クラス

TextWriter コンストラクタ ()

TextWriter コンストラクタ (IFormatProvider)

TextWriter コンストラクタ

関連項目

その他の技術情報

TextWriter フィールド

関連項目

その他の技術情報

TextWriter プロパティ

関連項目

その他の技術情報

TextWriter メソッド

関連項目

その他の技術情報

TextWriter メンバ

関連項目

その他の技術情報

「TextWriter」の関連用語

TextWriterとは？わかりやすく解説

テキストライタ [text writer]