UnmanagedMemoryStream.Initialize Метод

Определение

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере или с помощью указателя на неуправляемое расположение в памяти.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer, or by using a pointer to an unmanaged memory location.

Перегрузки

Initialize(Byte*, Int64, Int64, FileAccess)

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя указатель на неуправляемое расположение в памяти.Initializes a new instance of the UnmanagedMemoryStream class by using a pointer to an unmanaged memory location.

Initialize(SafeBuffer, Int64, Int64, FileAccess)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанными смещением, длиной и правами доступа к файлам.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset, length, and file access.

Initialize(Byte*, Int64, Int64, FileAccess)

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса UnmanagedMemoryStream, используя указатель на неуправляемое расположение в памяти.Initializes a new instance of the UnmanagedMemoryStream class by using a pointer to an unmanaged memory location.

protected:
 void Initialize(System::Byte* pointer, long length, long capacity, System::IO::FileAccess access);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
protected void Initialize (byte* pointer, long length, long capacity, System.IO.FileAccess access);
protected void Initialize (byte* pointer, long length, long capacity, System.IO.FileAccess access);
[System.CLSCompliant(false)]
protected void Initialize (byte* pointer, long length, long capacity, System.IO.FileAccess access);
member this.Initialize : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> unit

Параметры

pointer
Byte*

Указатель на расположение неуправляемой памяти.A pointer to an unmanaged memory location.

length
Int64

Используемый объем памяти.The length of the memory to use.

capacity
Int64

Общий объем памяти, назначенный для потока.The total amount of memory assigned to the stream.

access
FileAccess

Одно из значений перечисления FileAccess.One of the FileAccess values.

Атрибуты

Исключения

Пользователь не имеет необходимого разрешения.The user does not have the required permission.

Значение параметра pointernull.The pointer value is null.

Значение параметра length меньше нуля.The length value is less than zero.

-или--or- Значение параметра capacity меньше нуля.The capacity value is less than zero.

-или--or- Значение параметра length достаточно велико, чтобы привести к переполнению.The length value is large enough to cause an overflow.

Комментарии

Этот метод эквивалентен конструктору UnmanagedMemoryStream.This method is equivalent to the UnmanagedMemoryStream constructor. Он поддерживает методы, которым необходимо инициализировать указатель перед настройкой переменных потока и, следовательно, не может вызывать параметризованный конструктор.It supports methods that need to initialize the pointer before setting stream variables and, therefore, cannot call the parameterized constructor. В таких методах следует использовать конструктор без параметров, UnmanagedMemoryStream(), инициализировать указатель, а затем вызвать метод Initialize.Such methods should use the parameterless constructor, UnmanagedMemoryStream(), initialize the pointer, and then invoke the Initialize method.

Initialize(SafeBuffer, Int64, Int64, FileAccess)

Инициализирует новый экземпляр класса UnmanagedMemoryStream в безопасном буфере с указанными смещением, длиной и правами доступа к файлам.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer with a specified offset, length, and file access.

protected:
 void Initialize(System::Runtime::InteropServices::SafeBuffer ^ buffer, long offset, long length, System::IO::FileAccess access);
protected void Initialize (System.Runtime.InteropServices.SafeBuffer buffer, long offset, long length, System.IO.FileAccess access);
member this.Initialize : System.Runtime.InteropServices.SafeBuffer * int64 * int64 * System.IO.FileAccess -> unit
Protected Sub Initialize (buffer As SafeBuffer, offset As Long, length As Long, access As FileAccess)

Параметры

buffer
SafeBuffer

Буфер, который должен содержать поток неуправляемой памяти.The buffer to contain the unmanaged memory stream.

offset
Int64

Позиция байта в буфере, с которой должен начинаться поток неуправляемой памяти.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

Длина потока неуправляемой памяти.The length of the unmanaged memory stream.

access
FileAccess

Режим доступа к файлам для потока неуправляемой памяти.The mode of file access to the unmanaged memory stream.

Применяется к