UnmanagedMemoryStream.Initialize Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da UnmanagedMemoryStream classe num buffer seguro, ou usando um ponteiro para uma localização de memória não gerida.
Sobrecargas
| Name | Description |
|---|---|
| Initialize(Byte*, Int64, Int64, FileAccess) |
Inicializa uma nova instância da UnmanagedMemoryStream classe usando um ponteiro para uma localização de memória não gerida. |
| Initialize(SafeBuffer, Int64, Int64, FileAccess) |
Inicializa uma nova instância da UnmanagedMemoryStream classe num buffer seguro com um offset, comprimento e acesso ao ficheiro especificados. |
Initialize(Byte*, Int64, Int64, FileAccess)
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da UnmanagedMemoryStream classe usando um ponteiro para uma localização de memória não gerida.
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);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Initialize : nativeptr<byte> * int64 * int64 * System.IO.FileAccess -> unit
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
Parâmetros
- pointer
- Byte*
Um apontador para uma localização de memória não gerida.
- length
- Int64
O comprimento da memória a usar.
- capacity
- Int64
A quantidade total de memória atribuída ao fluxo.
- access
- FileAccess
Um dos FileAccess valores.
- Atributos
Exceções
O utilizador não tem a permissão necessária.
O pointer valor é null.
O length valor é inferior a zero.
-ou-
O capacity valor é inferior a zero.
-ou-
O length valor é suficientemente elevado para causar um transbordo.
Observações
Este método é equivalente UnmanagedMemoryStream ao construtor. Suporta métodos que precisam de inicializar o ponteiro antes de definir variáveis de fluxo e, por isso, não pode chamar o construtor parametrizado. Tais métodos devem usar o construtor sem parâmetros, UnmanagedMemoryStream(), inicializar o ponteiro e depois invocar o Initialize método.
Aplica-se a
Initialize(SafeBuffer, Int64, Int64, FileAccess)
Inicializa uma nova instância da UnmanagedMemoryStream classe num buffer seguro com um offset, comprimento e acesso ao ficheiro 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 para conter o fluxo de memória não gerido.
- offset
- Int64
A posição do byte no buffer onde iniciar o fluxo de memória não gerido.
- length
- Int64
O comprimento do fluxo de memória não gerido.
- access
- FileAccess
O modo de acesso a ficheiros ao fluxo de memória não gerido.