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.

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)

Origem:
UnmanagedMemoryStream.cs
Origem:
UnmanagedMemoryStream.cs
Origem:
UnmanagedMemoryStream.cs

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.

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

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

Exceções

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

O valor pointer é null.

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 invocar o Initialize método .

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Initialize(SafeBuffer, Int64, Int64, FileAccess)

Origem:
UnmanagedMemoryStream.cs
Origem:
UnmanagedMemoryStream.cs
Origem:
UnmanagedMemoryStream.cs

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

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.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0