MemoryStream 构造函数

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

初始化 MemoryStream 类的新实例。

重载

MemoryStream()	使用初始化为零的可扩展容量初始化 MemoryStream 类的新实例。
MemoryStream(Byte[])	基于指定的字节数组初始化 MemoryStream 类的无法调整大小的新实例。
MemoryStream(Int32)	使用按指定要求初始化的可扩展容量初始化 MemoryStream 类的新实例。
MemoryStream(Byte[], Boolean)	在 CanWrite 属性按指定设置的状态下，基于指定的字节数组初始化 MemoryStream 类的无法调整大小的新实例。
MemoryStream(Byte[], Int32, Int32)	基于字节数组的指定区域（索引）初始化 MemoryStream 类的无法调整大小的新实例。
MemoryStream(Byte[], Int32, Int32, Boolean)	在 MemoryStream 属性按指定设置的状态下，基于字节数组的指定区域，初始化 CanWrite 类的无法调整大小的新实例。
MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)	在 MemoryStream 属性和调用 CanWrite 的能力按指定设置的状态下，基于字节数组的指定区域初始化 GetBuffer() 类的新实例。

MemoryStream()

Source:

MemoryStream.cs

使用初始化为零的可扩展容量初始化 MemoryStream 类的新实例。

public:
 MemoryStream();

public MemoryStream ();

Public Sub New ()

注解

CanRead、 CanSeek和 CanWrite 属性都设置为 true。

使用 SetLength 方法将长度设置为大于当前流的容量的值时，当前流的容量会自动增加。

此构造函数公开返回的基础流 GetBuffer 。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Byte[])

Source:

MemoryStream.cs

基于指定的字节数组初始化 MemoryStream 类的无法调整大小的新实例。

public:
 MemoryStream(cli::array <System::Byte> ^ buffer);

public MemoryStream (byte[] buffer);

new System.IO.MemoryStream : byte[] -> System.IO.MemoryStream

Public Sub New (buffer As Byte())

参数

buffer

Byte[]

从中创建当前流的无符号字节数组。

例外

ArgumentNullException

buffer 为 null。

注解

CanRead、 CanSeek和 CanWrite 属性都设置为 true。 Capacity 设置为指定字节数组的长度。 新流可以写入，但不可调整大小。

流的长度不能设置为大于指定字节数组的初始长度的值;但是，流可以截断 (看到 SetLength) 。

此构造函数不公开基础流。 GetBuffer 引发 UnauthorizedAccessException。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Int32)

Source:

MemoryStream.cs

使用按指定要求初始化的可扩展容量初始化 MemoryStream 类的新实例。

public:
 MemoryStream(int capacity);

public MemoryStream (int capacity);

new System.IO.MemoryStream : int -> System.IO.MemoryStream

Public Sub New (capacity As Integer)

参数

capacity

Int32

内部数组的初始大小（以字节为单位）。

例外

ArgumentOutOfRangeException

capacity 为负数。

示例

此代码示例是为 MemoryStream 类提供的一个更大示例的一部分。

MemoryStream^ memStream = gcnew MemoryStream( 100 );

using(MemoryStream memStream = new MemoryStream(100))

Dim memStream As New MemoryStream(100)

注解

CanRead、 CanSeek和 CanWrite 属性都设置为 true。

使用 SetLength 方法将长度设置为大于当前流的容量的值时，容量会自动增加。 除了 MemoryStream 使用 byte[] 参数构造的 之外，在 末尾的 MemoryStream 写入操作会扩展 MemoryStream。

此构造函数公开返回的基础流 GetBuffer 。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Byte[], Boolean)

Source:

MemoryStream.cs

在 CanWrite 属性按指定设置的状态下，基于指定的字节数组初始化 MemoryStream 类的无法调整大小的新实例。

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, bool writable);

public MemoryStream (byte[] buffer, bool writable);

new System.IO.MemoryStream : byte[] * bool -> System.IO.MemoryStream

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

参数

buffer

Byte[]

从中创建此流的无符号字节的数组。

writable

Boolean

CanWrite 属性的设置，确定该流是否支持写入。

例外

ArgumentNullException

buffer 为 null。

注解

和 CanReadCanSeek 属性都设置为 true。 Capacity 设置为指定字节数组的长度。

流的长度不能设置为大于指定字节数组的初始长度的值;但是，流可以截断 (看到 SetLength) 。

此构造函数不公开基础流。 GetBuffer 引发 UnauthorizedAccessException。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Byte[], Int32, Int32)

Source:

MemoryStream.cs

基于字节数组的指定区域（索引）初始化 MemoryStream 类的无法调整大小的新实例。

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count);

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

new System.IO.MemoryStream : byte[] * int * int -> System.IO.MemoryStream

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

参数

buffer

Byte[]

从中创建此流的无符号字节的数组。

index

Int32

buffer 内的索引，流从此处开始。

count

Int32

流的长度（以字节为单位）。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

index 或 count 小于零。

ArgumentException

缓冲区长度减去 index 小于 count。

注解

CanRead、 CanSeek和 CanWrite 属性都设置为 true，但容量不能更改。 将 Capacity 设置为 count。

流的长度不能设置为大于指定字节数组的初始长度的值;但是，流可以截断 (看到 SetLength) 。

此构造函数不公开基础流。 GetBuffer 引发 UnauthorizedAccessException。 但是，可以写入流。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Byte[], Int32, Int32, Boolean)

Source:

MemoryStream.cs

在 MemoryStream 属性按指定设置的状态下，基于字节数组的指定区域，初始化 CanWrite 类的无法调整大小的新实例。

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable);

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

new System.IO.MemoryStream : byte[] * int * int * bool -> System.IO.MemoryStream

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

参数

buffer

Byte[]

从中创建此流的无符号字节的数组。

index

Int32

buffer 内的索引，流从此处开始。

count

Int32

流的长度（以字节为单位）。

writable

Boolean

CanWrite 属性的设置，确定该流是否支持写入。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

index 或 count 为负。

ArgumentException

缓冲区长度减去 index 小于 count。

注解

和 CanReadCanSeek 属性都设置为 true。 将 Capacity 设置为 count。

流的长度不能设置为大于指定字节数组的初始长度的值;但是，流可以截断 (看到 SetLength) 。

此构造函数不公开基础流。 GetBuffer 引发 UnauthorizedAccessException。 但是，如果 writable 为 true，则可以写入流。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)

Source:

MemoryStream.cs

在 MemoryStream 属性和调用 CanWrite 的能力按指定设置的状态下，基于字节数组的指定区域初始化 GetBuffer() 类的新实例。

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable, bool publiclyVisible);

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

new System.IO.MemoryStream : byte[] * int * int * bool * bool -> System.IO.MemoryStream

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

参数

buffer

Byte[]

从中创建此流的无符号字节的数组。

index

Int32

buffer 内的索引，流从此处开始。

count

Int32

流的长度（以字节为单位）。

writable

Boolean

CanWrite 属性的设置，确定该流是否支持写入。

publiclyVisible

Boolean

设置为 true 可以启用 GetBuffer()，它返回无符号字节数组，流从该数组创建；否则为 false。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

index 或 count 为负数。

ArgumentException

缓冲区长度减去 index 小于 count。

注解

和 CanReadCanSeek 属性都设置为 true。 将 Capacity 设置为 count。

可以将新的流实例写入，但 Capacity 无法更改基础字节数组的 。 流的长度不能设置为大于指定字节数组的初始长度的值;但是，流可以截断 (看到 SetLength) 。

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件