次の方法で共有

FileStream.SetLength メソッド

  • [アーティクル]

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

Overrides Public Sub SetLength( _
   ByVal value As Long _)
[C#]
public override void SetLength(longvalue);
[C++]
public: void SetLength(__int64value);
[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 NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

FileStream クラス | FileStream メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み