UnmanagedMemoryStream.Initialize Método

Definição

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro usando um ponteiro para um local de memória não gerenciada.Initializes a new instance of the UnmanagedMemoryStream class in a safe buffer, or by using a pointer to an unmanaged memory location.

Sobrecargas

Initialize(Byte*, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream usando um ponteiro para um local de memória não gerenciada.Initializes a new instance of the UnmanagedMemoryStream class by using a pointer to an unmanaged memory location.

Initialize(SafeBuffer, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com um deslocamento, tamanho e acesso a arquivos especificados.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)

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe UnmanagedMemoryStream usando um ponteiro para um local de memória não gerenciada.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);
member this.Initialize : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> unit

Parâmetros

pointer
Byte*

Um ponteiro para um local da memória não gerenciado.A pointer to an unmanaged memory location.

length
Int64

O tamanho da memória a ser usado.The length of the memory to use.

capacity
Int64

A quantidade total de memória atribuída ao fluxo.The total amount of memory assigned to the stream.

access
FileAccess

Um dos valores de FileAccess.One of the FileAccess values.

Atributos

Exceções

O usuário não tem a permissão necessária.The user does not have the required permission.

O valor pointer é null.The pointer value is null.

O valor length é menor que zero.The length value is less than zero.

- ou --or- O valor capacity é menor que zero.The capacity value is less than zero.

- ou --or- O valor length é grande o suficiente para causar um estouro.The length value is large enough to cause an overflow.

Comentários

Esse método é equivalente ao UnmanagedMemoryStream Construtor.This method is equivalent to the UnmanagedMemoryStream constructor. Ele dá suporte a métodos que precisam inicializar o ponteiro antes de definir variáveis de fluxo e, portanto, não pode chamar o construtor parametrizado.It supports methods that need to initialize the pointer before setting stream variables and, therefore, cannot call the parameterized constructor. Esses métodos devem usar o construtor sem parâmetros, UnmanagedMemoryStream(), inicializar o ponteiro e, em seguida, Initialize invocar o método.Such methods should use the parameterless constructor, UnmanagedMemoryStream(), initialize the pointer, and then invoke the Initialize method.

Segurança

UnmanagedCode
para acessar a memória não gerenciada.for accessing unmanaged memory.

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Initialize(SafeBuffer, Int64, Int64, FileAccess)

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro com um deslocamento, tamanho e acesso a arquivos especificados.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)

Parâmetros

buffer
SafeBuffer

O buffer que conterá o fluxo de memória não gerenciada.The buffer to contain the unmanaged memory stream.

offset
Int64

A posição de bytes no buffer na qual o fluxo de memória não gerenciada será iniciado.The byte position in the buffer at which to start the unmanaged memory stream.

length
Int64

O tamanho do fluxo de memória não gerenciada.The length of the unmanaged memory stream.

access
FileAccess

O modo de acesso ao arquivo para o fluxo de memória não gerenciada.The mode of file access to the unmanaged memory stream.

Aplica-se a