Stream.SetLength メソッド

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

Stream.SetLength メソッド

派生クラスでオーバーライドされた場合は、現在のストリームの長さを設定します。

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

Visual Basic (宣言)

Public MustOverride Sub
 SetLength ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As Stream
Dim value As Long

instance.SetLength(value)

C#

public abstract void SetLength (
    long value
)

C++

public:
virtual void SetLength (
    long long value
) abstract

J#

public abstract void SetLength (
    long value
)

JScript

public abstract function SetLength (
    value : long
)

パラメータ

value

現在のストリームの希望の長さ (バイト数)。

例外

例外の種類	条件
IOException	I/O エラーが発生しました。
NotSupportedException	ストリームが書き込みとシークの両方をサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

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

ストリームの現在の長さより小さい値を指定した場合は、ストリームが切り捨てられます。ストリームの現在の長さより大きい値を設定した場合は、ストリームが拡張されます。ストリームが拡張された場合、元の長さと新しい長さの間のストリームの内容は不明です。

SetLength が機能するためには、ストリームが書き込みとシークの両方をサポートしていることが必要です。

CanWrite プロパティを使用して、現在のインスタンスが書き込みをサポートしているかどうかを判断します。また、CanSeek プロパティを使用して、シークをサポートしているかどうかを判断します。

プラットフォーム

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 クラス
Stream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む