ストリーム長 (バイト単位) を取得します。
Overrides Public ReadOnly Property Length As Long
[C#]
public override long Length {get;}
[C++]
public: __property __int64 get_Length();
[JScript]
public override function get Length() : long;
プロパティ値
ストリーム長 (バイト単位) を表す long 値。
例外
| 例外の種類 | 条件 |
|---|---|
| NotSupportedException | このストリーム用の CanSeek が false です。 |
| IOException | I/O エラーが発生しました。たとえば、ファイルが閉じられています。 |
解説
このプロパティの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
| 実行するタスク | 参考例があるトピック |
|---|---|
| テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
| テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
| テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
| テキストをファイルに追加する。 | ログ ファイルのオープンと追加 |
| ファイルの名前を変更、またはファイルを移動する。 | File.Move |
| ファイルをコピーする。 | File.Copy |
| ディレクトリのサイズを取得する。 | FileInfo.Length |
| ファイルの属性を取得する。 | File.GetAttributes |
| ファイルの属性を設定する。 | File.SetAttributes |
| サブディレクトリを作成する。 | CreateSubdirectory |
| バイナリ ファイルから読み取る。 | 新しく作成したデータ ファイルの読み取りと書き込み |
| バイナリ ファイルに書き込む。 | 新しく作成したデータ ファイルの読み取りと書き込み |
| ディレクトリ内のファイルを参照する。 | Name |
| ディレクトリ内のファイルをサイズ順に並べ替える。 | GetFileSystemInfos |
使用例
Length プロパティと Position プロパティを使用して EOF (end-of-file) 条件を確認する例を次に示します。
If s.Length = s.Position Then
Console.WriteLine("End of file has been reached.")
End If
[C#]
if( s.Length==s.Position )
{
Console.WriteLine("End of file has been reached.");
}
[C++]
if( s->Length == s->Position )
{
Console::WriteLine(S"End of file has been reached.");
}
[JScript]
if( s.Length==s.Position )
Console.WriteLine("End of file has been reached.");
必要条件
プラットフォーム: 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 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み