UnmanagedMemoryStream.Initialize Método

Definição

Namespace:

System.IO

Assemblies:

mscorlib.dll, System.IO.UnmanagedMemoryStream.dll

Assembly:

System.Runtime.dll

Assembly:

System.IO.UnmanagedMemoryStream.dll

Assembly:

System.Runtime.InteropServices.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Inicializa uma nova instância da classe UnmanagedMemoryStream em um buffer seguro usando um ponteiro para um local de memória não gerenciada.

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.
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.

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.

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);

[System.CLSCompliant(false)]
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)>]
[<System.Security.SecurityCritical>]
member this.Initialize : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> unit

[<System.CLSCompliant(false)>]
member this.Initialize : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> unit

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.

length

Int64

O tamanho da memória a ser usado.

capacity

Int64

A quantidade total de memória atribuída ao fluxo.

access

FileAccess

Um dos valores de FileAccess.

Atributos

CLSCompliantAttribute SecurityCriticalAttribute

Exceções

SecurityException

O usuário não tem a permissão necessária.

ArgumentNullException

O valor pointer é null.

ArgumentOutOfRangeException

O valor length é menor que zero.

- ou - O valor capacity é menor que zero.

- ou - O valor length é grande o suficiente para causar um estouro.

Comentários

Esse método é equivalente ao UnmanagedMemoryStream construtor. 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. Esses métodos devem usar o construtor sem parâmetros, UnmanagedMemoryStream()inicializar o ponteiro e, em seguida, invocar o Initialize método.

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.

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.

offset

Int64

A posição de bytes no buffer na qual o fluxo de memória não gerenciada será iniciado.

length

Int64

O tamanho do fluxo de memória não gerenciada.

access

FileAccess

O modo de acesso ao arquivo para o fluxo de memória não gerenciada.