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

すべての辞書から再検索する

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

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

Stream クラス

バイトシーケンスのジェネリックビューを提供します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As Stream

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

C++

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

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

JScript

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

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「方法 : ファイルにテキストを書き込む」を参照してください。ファイルからのテキストの読み取りの例については、「方法 : ファイルからテキストを読み取る」を参照してください。バイナリファイルの読み取りおよび書き込みの例については、「方法 : 新しく作成されたデータファイルに対して読み書きする」を参照してください。

ストリームには次の 3 つの基本的な操作が含まれます。

ストリームからの読み込み。読み込みは、ストリームからデータ構造体 (バイト配列など) へのデータ転送です。
ストリームへの書き込み。書き込みは、データ構造体からストリームへのデータ転送です。
ストリームによるシークのサポート。シークとは、ストリーム内の現在位置を問い合せ、変更することです。シーク機能は、ストリームが持つバッキングストアの種類によって異なります。たとえば、ネットワークのストリームは、現在位置という統一された概念を持たないため、通常はシークをサポートしません。

Stream は、すべてのストリームの抽象基本クラスです。ストリームは、ファイル、入出力デバイス、プロセス間通信パイプ、TCP/IP ソケットなど、バイトシーケンスの抽象化です。Stream クラスとその派生クラスは、これらのさまざまな種類の入出力のジェネリックビューを提供します。これにより、プログラマはオペレーティングシステムや基になるデバイスに固有のディテールを分離します。

基になるデータソースやリポジトリによっては、ストリームがこれらの機能の一部だけをサポートする場合もあります。アプリケーションで CanRead プロパティ、CanWrite プロパティ、および CanSeek プロパティを使用することにより、ストリームの機能を問い合わせることができます。

Read メソッドおよび Write メソッドはさまざまな形式でデータの読み取りと書き込みをします。シークをサポートするストリームの場合は、Seek メソッドや SetLength メソッド、および Position プロパティや Length プロパティを使用して、ストリームの現在位置および長さを問い合わせ、変更します。

ストリームの実装によっては、パフォーマンスの向上のために、基になるデータをローカルでバッファリングする場合があります。このようなストリームでは、Flush メソッドを使用して内部バッファをクリアし、すべてのデータが基になるデータソースやリポジトリに確実に書き込まれることを保証できます。

Stream に対して Close を呼び出すと、Flush が呼び出されてバッファ内のすべてのデータがフラッシュされます。また、Close によって、内部バッファリングに使用したファイルハンドル、ネットワーク接続、メモリなどのオペレーティングシステムリソースが解放されます。BufferedStream クラスは、読み取りと書き込みのパフォーマンスを向上させるために、バッファリングされたストリームを別のストリームでラッピングする機能を提供します。

バッキングストア (ビットバケット) なしのストリームが必要な場合は、Null を使用します。

実装時の注意 Stream の派生クラスを実装するときは、Read メソッドおよび Write メソッドの実装を提供する必要があります。非同期メソッド BeginRead、EndRead、BeginWrite、および EndWrite は、同期メソッド Read および Write を使用して実装します。同様に、独自の Read および Write の実装は、非同期メソッドと共に正常に動作します。ReadByte および WriteByte の既定の実装は、新しい単一要素のバイト配列を作成した後で、独自の Read および Write を呼び出します。Stream から派生させるとき、内部バイトバッファを使用する場合は、内部バッファにアクセスするようにメソッドをオーバーライドすることを強くお勧めします。これにより、パフォーマンスが大幅に向上します。CanRead、CanSeek、CanWrite、Flush、Length、Position、Seek、および SetLength も実装する必要があります。 Close メソッドをオーバーライドしないでください。代わりに、Dispose メソッドにすべてのストリームクリーンアップロジックを組み込みます。詳細については、「Dispose メソッドの実装」を参照してください。

継承階層

System.Object
   System.MarshalByRefObject
    System.IO.Stream
       派生クラス

スレッドセーフ

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

参照

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

Stream コンストラクタ

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

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New Stream

protected Stream ()

C++

protected:
Stream ()

protected Stream ()

JScript

protected function Stream ()

プラットフォーム

バージョン情報

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

参照

関連項目
Stream クラス
Stream メンバ
System.IO 名前空間

Stream フィールド

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

	名前	説明
	Null	バッキングストアを持たない Stream。

参照

その他の技術情報

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

Stream プロパティ

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

	名前	説明
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。

参照

その他の技術情報

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

Stream メソッド

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

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

	名前	説明
	BeginRead	非同期の読み込み動作を開始します。
	BeginWrite	非同期の書き込み操作を開始します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。
	EndRead	保留中の非同期読み取りが完了するまで待機します。
	EndWrite	非同期書き込み操作を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	派生クラスによってオーバーライドされた場合は、ストリームに対応するすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Read	派生クラスによってオーバーライドされた場合は、現在のストリームからバイトシーケンスを読み取り、読み取ったバイト数の分だけストリームの位置を進めます。
	ReadByte	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Seek	派生クラスでオーバーライドされた場合は、現在のストリーム内の位置を設定します。
	SetLength	派生クラスでオーバーライドされた場合は、現在のストリームの長さを設定します。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Write	派生クラスによってオーバーライドされた場合は、現在のストリームにバイトシーケンスを書き込み、書き込んだバイト数の分だけストリームの現在位置を進めます。
	WriteByte	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。

プロテクトメソッド

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

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

	名前	説明
	System.IDisposable.Dispose

参照

その他の技術情報

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

Stream メンバ

バイトシーケンスのジェネリックビューを提供します。

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

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

	名前	説明
	Stream	Stream クラスの新しいインスタンスを初期化します。

パブリックフィールド

	名前	説明
	Null	バッキングストアを持たない Stream。

パブリックプロパティ

	名前	説明
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。

パブリックメソッド

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

	名前	説明
	BeginRead	非同期の読み込み動作を開始します。
	BeginWrite	非同期の書き込み操作を開始します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。
	EndRead	保留中の非同期読み取りが完了するまで待機します。
	EndWrite	非同期書き込み操作を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	派生クラスによってオーバーライドされた場合は、ストリームに対応するすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Read	派生クラスによってオーバーライドされた場合は、現在のストリームからバイトシーケンスを読み取り、読み取ったバイト数の分だけストリームの位置を進めます。
	ReadByte	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Seek	派生クラスでオーバーライドされた場合は、現在のストリーム内の位置を設定します。
	SetLength	派生クラスでオーバーライドされた場合は、現在のストリームの長さを設定します。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Write	派生クラスによってオーバーライドされた場合は、現在のストリームにバイトシーケンスを書き込み、書き込んだバイト数の分だけストリームの現在位置を進めます。
	WriteByte	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。

プロテクトメソッド

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