UnmanagedMemoryStream.SetLength メソッド

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

UnmanagedMemoryStream.SetLength メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

このメソッドは、CLS に準拠していません。  

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

Visual Basic (宣言)

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As UnmanagedMemoryStream
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 エラーが発生しました。
ObjectDisposedException	ストリームが閉じられました。
NotSupportedException	基になるメモリが書き込みをサポートしていません。 または ストリームへの書き込みが行われようとしましたが、CanWrite プロパティが false です。
ArgumentOutOfRangeException	指定した value がストリームの容量を超えています。 または 指定した value が負の値です。

解説

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
UnmanagedMemoryStream クラス
UnmanagedMemoryStream メンバ
System.IO 名前空間