MemoryStream.Capacity プロパティ

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

MemoryStream.Capacity プロパティ

ストリームに割り当てられたバイト数を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 Capacity As Integer

Visual Basic (使用法)

Dim instance As MemoryStream
Dim value As Integer

value = instance.Capacity

instance.Capacity = value

C#

public virtual int Capacity { get;
 set; }

C++

public:
virtual property int Capacity {
    int get ();
    void set (int value);
}

J#

/** @property */
public int get_Capacity ()

/** @property */
public void set_Capacity (int
 value)

JScript

public function get Capacity
 () : int

public function set Capacity
 (value : int)

プロパティ値
ストリームに対してバッファが使用できる部分の長さ。

例外

例外の種類	条件
ArgumentOutOfRangeException	容量が負の値または現在のストリーム長より小さい値に設定されています。
ObjectDisposedException	現在のストリームが閉じています。
NotSupportedException	容量を変更できないストリームに対して set が呼び出されました。

解説

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

Capacity は、システムが提供するバイト配列のバッファ長です。Capacity は現在のストリーム長より小さい値には設定できません。

使用例

このコード例は、MemoryStream クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Write the stream properties to the console.
Console.WriteLine( _
    "Capacity = {0}, Length = {1}, Position = {2}",
 _
    memStream.Capacity.ToString(), _
    memStream.Length.ToString(), _
    memStream.Position.ToString())

C#

// Write the stream properties to the console.
Console.WriteLine(
    "Capacity = {0}, Length = {1}, Position = {2}\n",
    memStream.Capacity.ToString(), 
    memStream.Length.ToString(), 
    memStream.Position.ToString());

C++

// Write the stream properties to the console.
Console::WriteLine( "Capacity = {0}, Length = {1}, "
"Position = {2}\n", memStream->Capacity.ToString(), memStream->Length.ToString(),
 memStream->Position.ToString() );

J#

// Write the stream properties to the console.
Console.WriteLine(
    "Capacity = {0}, Length = {1}, Position = {2}\n", 
    (new Integer( memStream.get_Capacity())).ToString(),
    (new Long ( memStream.get_Length())).ToString(),
    (new Long ( memStream.get_Position())).ToString());

プラットフォーム

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

参照

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