FileStream.SetLength メソッド

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

FileStream.SetLength メソッド

ストリーム長を特定の値に設定します。

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

Visual Basic (宣言)

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As FileStream
Dim value As Long

instance.SetLength(value)

C#

public override void SetLength (
    long value
)

C++

public:
virtual void SetLength (
    long long value
) override

J#

public void SetLength (
    long value
)

JScript

public override function SetLength (
    value : long
)

パラメータ

value

新しいストリーム長。

例外

例外の種類	条件
IOException	I/O エラーが発生しました。
NotSupportedException	ストリームが書き込みもシークもサポートしていません。
ArgumentOutOfRangeException	value パラメータを 0 未満の値に設定しようとしました。

解説

このメソッドは、SetLength をオーバーライドします。

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

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

メモ
CanWrite プロパティを使用して、現在のインスタンスが書き込みをサポートしているかどうかを判断します。また、CanSeek プロパティを使用して、シークをサポートしているかどうかを判断します。詳細については、CanWrite および CanSeek の各トピックを参照してください。

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

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ディレクトリのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
サブディレクトリを作成する。	CreateSubdirectory
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
ディレクトリ内のファイルを参照する。	Name
ディレクトリ内のファイルをサイズ順に並べ替える。	GetFileSystemInfos

プラットフォーム

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

参照

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