MemoryStream コンストラクタ ()

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

MemoryStream コンストラクタ ()

MemoryStream クラスの新しいインスタンスを、0 に初期化される拡張可能な容量を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New MemoryStream

C#

public MemoryStream ()

C++

public:
MemoryStream ()

J#

public MemoryStream ()

JScript

public function MemoryStream ()

解説

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

CanRead、CanSeek、CanWrite の各プロパティは、すべて true に設定されます。

現在のストリームの容量は、SetLength メソッドを使用して、現在のストリームの容量を超える値にストリーム長を設定した場合に、自動的に増加します。

このコンストラクタは、GetBuffer が返す基になるストリームを公開します。

プラットフォーム

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

MemoryStream コンストラクタ (Byte[], Boolean)

CanWrite プロパティを指定どおりに設定し、指定したバイト配列に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    buffer As Byte(), _
    writable As Boolean _
)

Visual Basic (使用法)

Dim buffer As Byte()
Dim writable As Boolean

Dim instance As New MemoryStream(buffer,
 writable)

C#

public MemoryStream (
    byte[] buffer,
    bool writable
)

C++

public:
MemoryStream (
    array<unsigned char>^ buffer, 
    bool writable
)

J#

public MemoryStream (
    byte[] buffer, 
    boolean writable
)

JScript

public function MemoryStream (
    buffer : byte[], 
    writable : boolean
)

パラメータ

buffer

このストリームの作成元の符号なしバイトの配列。

writable

ストリームが書き込みをサポートするかどうかを決定する CanWrite プロパティの設定。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。

解説

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

CanRead プロパティと CanSeek プロパティはどちらも true に設定されます。Capacity は、指定したバイト配列の長さに設定されます。

ストリーム長は、指定したバイト配列の初期長を超える値に設定することはできません。ただし、ストリームを切り詰めることはできます。SetLength のトピックを参照してください。

このコンストラクタは、基になるストリームを公開しません。GetBuffer は UnauthorizedAccessException をスローします。

プラットフォーム

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

MemoryStream コンストラクタ (Byte[], Int32, Int32)

バイト配列の指定した領域 (インデックス) に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer _
)

Visual Basic (使用法)

Dim buffer As Byte()
Dim index As Integer
Dim count As Integer

Dim instance As New MemoryStream(buffer,
 index, count)

C#

public MemoryStream (
    byte[] buffer,
    int index,
    int count
)

C++

public:
MemoryStream (
    array<unsigned char>^ buffer, 
    int index, 
    int count
)

J#

public MemoryStream (
    byte[] buffer, 
    int index, 
    int count
)

JScript

public function MemoryStream (
    buffer : byte[], 
    index : int, 
    count : int
)

パラメータ

buffer

このストリームの作成元の符号なしバイトの配列。

index

ストリームが開始する位置の buffer のインデックス。

count

バイト単位のストリーム長。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	index または count が 0 未満です。
ArgumentException	index と count の合計値が、buffer の長さを超えています。

解説

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

CanRead、CanSeek、CanWrite の各プロパティはすべて、true に設定されますが、容量は変更できません。Capacity は count に設定されます。

ストリーム長は、指定したバイト配列の初期長を超える値に設定することはできません。ただし、ストリームを切り詰めることはできます。SetLength のトピックを参照してください。

このコンストラクタは、基になるストリームを公開しません。GetBuffer は UnauthorizedAccessException をスローします。ただし、ストリームに書き込むことはできます。

プラットフォーム

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

MemoryStream コンストラクタ (Byte[], Int32, Int32, Boolean, Boolean)

指定した CanWrite プロパティと指定した GetBuffer を呼び出す機能を設定して、バイト配列の指定した領域に基づき、MemoryStream クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer, _
    writable As Boolean, _
    publiclyVisible As Boolean _
)

Visual Basic (使用法)

Dim buffer As Byte()
Dim index As Integer
Dim count As Integer
Dim writable As Boolean
Dim publiclyVisible As Boolean

Dim instance As New MemoryStream(buffer,
 index, count, writable, publiclyVisible)

C#

public MemoryStream (
    byte[] buffer,
    int index,
    int count,
    bool writable,
    bool publiclyVisible
)

C++

public:
MemoryStream (
    array<unsigned char>^ buffer, 
    int index, 
    int count, 
    bool writable, 
    bool publiclyVisible
)

J#

public MemoryStream (
    byte[] buffer, 
    int index, 
    int count, 
    boolean writable, 
    boolean publiclyVisible
)

JScript

public function MemoryStream (
    buffer : byte[], 
    index : int, 
    count : int, 
    writable : boolean, 
    publiclyVisible : boolean
)

パラメータ

buffer

このストリームの作成元の符号なしバイトの配列。

index

ストリームが開始する位置の buffer のインデックス。

count

バイト単位のストリーム長。

writable

ストリームが書き込みをサポートするかどうかを決定する CanWrite プロパティの設定。

publiclyVisible

ストリームが作成した符号なしバイト配列を返す GetBuffer を有効にする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	index または count が負の値です。
ArgumentException	バッファ長から index を差し引いた値が count より小さい値です。

解説

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

CanRead プロパティと CanSeek プロパティはどちらも true に設定されます。Capacity は count に設定されます。

新しいストリーム インスタンスには書き込むことができますが、基になるバイト配列の Capacity は変更できません。ストリーム長は、指定したバイト配列の初期長を超える値に設定することはできません。ただし、ストリームを切り詰めることはできます。SetLength のトピックを参照してください。

プラットフォーム

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

MemoryStream コンストラクタ (Int32)

MemoryStream クラスの新しいインスタンスを、指定に従って初期化される拡張可能な容量を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    capacity As Integer _
)

Visual Basic (使用法)

Dim capacity As Integer

Dim instance As New MemoryStream(capacity)

C#

public MemoryStream (
    int capacity
)

C++

public:
MemoryStream (
    int capacity
)

J#

public MemoryStream (
    int capacity
)

JScript

public function MemoryStream (
    capacity : int
)

パラメータ

capacity

バイト単位の内部配列の初期サイズ。

例外

例外の種類	条件
ArgumentOutOfRangeException	capacity が負の値です。

解説

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

CanRead、CanSeek、CanWrite の各プロパティは、すべて true に設定されます。

容量は、SetLength メソッドを使用して、現在のストリームの容量を超える値にストリーム長を設定した場合に、自動的に増加します。byte[] パラメータで構築された MemoryStream 以外では、MemoryStream の末尾で書き込み操作を実行すると、MemoryStream が拡張されます。

このコンストラクタは、GetBuffer が返す基になるストリームを公開します。

使用例

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

Visual Basic

Dim memStream As New MemoryStream(100)

C#

using(MemoryStream memStream = new MemoryStream(100))

C++

MemoryStream^ memStream = gcnew MemoryStream( 100 );

J#

MemoryStream memStream =  new MemoryStream(100);

プラットフォーム

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

MemoryStream コンストラクタ (Byte[])

指定したバイト配列に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    buffer As Byte() _
)

Visual Basic (使用法)

Dim buffer As Byte()

Dim instance As New MemoryStream(buffer)

C#

public MemoryStream (
    byte[] buffer
)

C++

public:
MemoryStream (
    array<unsigned char>^ buffer
)

J#

public MemoryStream (
    byte[] buffer
)

JScript

public function MemoryStream (
    buffer : byte[]
)

パラメータ

buffer

現在のストリームを作成する符号なしバイトの配列。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。

解説

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

CanRead、CanSeek、CanWrite の各プロパティはすべて true に設定されます。Capacity は、指定したバイト配列の長さに設定されます。新しいストリームには書き込むことができますが、サイズは変更できません。

ストリーム長は、指定したバイト配列の初期長を超える値に設定することはできません。ただし、ストリームを切り詰めることはできます。SetLength のトピックを参照してください。

このコンストラクタは、基になるストリームを公開しません。GetBuffer は UnauthorizedAccessException をスローします。

プラットフォーム

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

MemoryStream コンストラクタ (Byte[], Int32, Int32, Boolean)

CanWrite プロパティを指定どおりに設定し、バイト配列の指定した領域に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer, _
    writable As Boolean _
)

Visual Basic (使用法)

Dim buffer As Byte()
Dim index As Integer
Dim count As Integer
Dim writable As Boolean

Dim instance As New MemoryStream(buffer,
 index, count, writable)

C#

public MemoryStream (
    byte[] buffer,
    int index,
    int count,
    bool writable
)

C++

public:
MemoryStream (
    array<unsigned char>^ buffer, 
    int index, 
    int count, 
    bool writable
)

J#

public MemoryStream (
    byte[] buffer, 
    int index, 
    int count, 
    boolean writable
)

JScript

public function MemoryStream (
    buffer : byte[], 
    index : int, 
    count : int, 
    writable : boolean
)

パラメータ

buffer

このストリームの作成元の符号なしバイトの配列。

index

ストリームが開始する位置の buffer のインデックス。

count

バイト単位のストリーム長。

writable

ストリームが書き込みをサポートするかどうかを決定する CanWrite プロパティの設定。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	index または count が負の値です。
ArgumentException	index と count の合計値が、buffer の長さを超えています。

解説

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

CanRead プロパティと CanSeek プロパティはどちらも true に設定されます。Capacity は count に設定されます。

ストリーム長は、指定したバイト配列の初期長を超える値に設定することはできません。ただし、ストリームを切り詰めることはできます。SetLength のトピックを参照してください。

このコンストラクタは、基になるストリームを公開しません。GetBuffer は UnauthorizedAccessException をスローします。ただし、writable が true の場合は、ストリームに書き込むことができます。

プラットフォーム

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

MemoryStream コンストラクタ

MemoryStream クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
MemoryStream ()	MemoryStream クラスの新しいインスタンスを、0 に初期化される拡張可能な容量を使用して初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Byte[])	指定したバイト配列に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Int32)	MemoryStream クラスの新しいインスタンスを、指定に従って初期化される拡張可能な容量を使用して初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Byte[], Boolean)	CanWrite プロパティを指定どおりに設定し、指定したバイト配列に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Byte[], Int32, Int32)	バイト配列の指定した領域 (インデックス) に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Byte[], Int32, Int32, Boolean)	CanWrite プロパティを指定どおりに設定し、バイト配列の指定した領域に基づいて、サイズを変更できない MemoryStream クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
MemoryStream (Byte[], Int32, Int32, Boolean, Boolean)	指定した CanWrite プロパティと指定した GetBuffer を呼び出す機能を設定して、バイト配列の指定した領域に基づき、MemoryStream クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

MemoryStream クラス
MemoryStream メンバ
System.IO 名前空間

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む