MemoryStream.SetLength メソッド

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

MemoryStream.SetLength メソッド

現在のストリーム長を指定した値に設定します。

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

Visual Basic (宣言)

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As MemoryStream
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

長さを設定する値。

例外

例外の種類	条件
NotSupportedException	現在のストリームのサイズが変更できません。value が現在の容量を超えています。 または 現在のストリームが書き込みをサポートしません。
ArgumentOutOfRangeException	value が負または MemoryStream の最大長より大きな値です。最大長は、(MaxValue - origin) で計算され、origin は、ストリームが開始する位置を示す基になるバッファのインデックスです。

解説

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

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

ストリームの現在の長さより小さい値を指定した場合は、ストリームが切り捨てられます。切り捨てた結果、ストリームの現在位置がストリームの末尾より後ろになった場合、ReadByte メソッドは -1 を返し、Read メソッドは指定されたバイト配列にゼロバイトを読み取り、Write メソッドおよび WriteByte メソッドは指定されたバイトをストリームの末尾に追加して長さを増やします。指定した値が現在の容量を超えていて、ストリームのサイズを変更できる場合は、容量が増加します。ストリームの現在位置は変更されません。ストリーム長が増加する場合、元のストリーム長と新しいストリーム長の間のストリームの内容はゼロに初期化されます。

メモ
このメソッドを動作させるには、MemoryStream インスタンスが書き込みをサポートしている必要があります現在のインスタンスが書き込みをサポートしているかどうかを判断するには、CanWrite プロパティを使用します。詳細については、CanWrite のトピックを参照してください。

プラットフォーム

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