SafeBuffer Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cuidado
SafeBuffer may be unavailable in future releases.
Fornece um buffer de memória controlado que pode ser usado para leitura e gravação. Tentativas de acessar a memória fora do buffer controlado (subexecuções e excessos) geram exceções.
public ref class SafeBuffer abstract : System::Runtime::InteropServices::SafeHandlepublic ref class SafeBuffer abstract : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid[System.Security.SecurityCritical]
public abstract class SafeBuffer : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[System.Security.SecurityCritical]
[System.Obsolete("SafeBuffer may be unavailable in future releases.")]
public abstract class SafeBuffer : System.Runtime.InteropServices.SafeHandlepublic abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
[<System.Obsolete("SafeBuffer may be unavailable in future releases.")>]
type SafeBuffer = class
inherit SafeHandletype SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalidPublic MustInherit Class SafeBuffer
Inherits SafeHandlePublic MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid- Herança
- Herança
- Derivado
- Atributos
Comentários
Você deve chamar o SafeBuffer.Initialize método antes de usar qualquer instância de SafeBuffer. Para evitar corridas ao armazenar uma instância de um SafeBuffer objeto em uma variável estática, você deve usar uma das seguintes abordagens:
Criar um bloqueio ao publicar o SafeBuffer.
Crie uma variável local, inicialize o SafeBuffere atribua a SafeBuffer variável estática, por exemplo, usando o Interlocked.CompareExchange método.
Note
As atribuições em um construtor de classe estática são bloqueadas implicitamente.
Construtores
| Nome | Description |
|---|---|
| SafeBuffer(Boolean) |
Obsoleto.
Cria uma nova instância da SafeBuffer classe e especifica se o identificador de buffer deve ser liberado de forma confiável. |
Campos
| Nome | Description |
|---|---|
| handle |
Obsoleto.
Especifica o identificador a ser encapsulado. (Herdado de SafeHandle) |
Propriedades
| Nome | Description |
|---|---|
| ByteLength |
Obsoleto.
Obtém o tamanho do buffer, em bytes. |
| IsClosed |
Obsoleto.
Obtém um valor que indica se o identificador está fechado. (Herdado de SafeHandle) |
| IsInvalid |
Obsoleto.
Obtém um valor que indica se o identificador é inválido. |
| IsInvalid |
Obsoleto.
Obtém um valor que indica se o identificador é inválido. (Herdado de SafeHandleZeroOrMinusOneIsInvalid) |
Métodos
| Nome | Description |
|---|---|
| AcquirePointer(Byte*) |
Obsoleto.
Obtém um ponteiro de um SafeBuffer objeto para um bloco de memória. |
| Close() |
Obsoleto.
Marca o identificador para liberar e liberar recursos. (Herdado de SafeHandle) |
| DangerousAddRef(Boolean) |
Obsoleto.
Incrementa manualmente o contador de referência em SafeHandle instâncias. (Herdado de SafeHandle) |
| DangerousGetHandle() |
Obsoleto.
Retorna o valor do handle campo. (Herdado de SafeHandle) |
| DangerousRelease() |
Obsoleto.
Diminui manualmente o contador de referência em uma SafeHandle instância. (Herdado de SafeHandle) |
| Dispose() |
Obsoleto.
Libera todos os recursos usados pela SafeHandle classe. (Herdado de SafeHandle) |
| Dispose(Boolean) |
Obsoleto.
Libera os recursos não gerenciados usados pela SafeHandle classe especificando se uma operação de descarte normal deve ser executada. (Herdado de SafeHandle) |
| Equals(Object) |
Obsoleto.
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Obsoleto.
Serve como a função hash predefinida. (Herdado de Object) |
| GetType() |
Obsoleto.
Obtém o Type da instância atual. (Herdado de Object) |
| Initialize(UInt32, UInt32) |
Obsoleto.
Especifica o tamanho da alocação do buffer de memória usando o número especificado de elementos e o tamanho do elemento. Você deve chamar esse método antes de usar a SafeBuffer instância. |
| Initialize(UInt64) |
Obsoleto.
Define o tamanho da alocação da região de memória em bytes. Você deve chamar esse método antes de usar a SafeBuffer instância. |
| Initialize<T>(UInt32) |
Obsoleto.
Define o tamanho da alocação da região de memória especificando o número de tipos de valor. Você deve chamar esse método antes de usar a SafeBuffer instância. |
| MemberwiseClone() |
Obsoleto.
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| Read<T>(UInt64) |
Obsoleto.
Lê um tipo de valor da memória no deslocamento especificado. |
| ReadArray<T>(UInt64, T[], Int32, Int32) |
Obsoleto.
Lê o número especificado de tipos de valor da memória começando no deslocamento e os grava em uma matriz começando no índice. |
| ReleaseHandle() |
Obsoleto.
Quando substituído em uma classe derivada, executa o código necessário para liberar o identificador. (Herdado de SafeHandle) |
| ReleasePointer() |
Obsoleto.
Libera um ponteiro obtido pelo AcquirePointer(Byte*) método. |
| SetHandle(IntPtr) |
Obsoleto.
Define o identificador para o identificador pré-existente especificado. (Herdado de SafeHandle) |
| SetHandleAsInvalid() |
Obsoleto.
Marca um identificador como não mais usado. (Herdado de SafeHandle) |
| ToString() |
Obsoleto.
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| Write<T>(UInt64, T) |
Obsoleto.
Grava um tipo de valor na memória no local especificado. |
| WriteArray<T>(UInt64, T[], Int32, Int32) |
Obsoleto.
Grava o número especificado de tipos de valor em um local de memória lendo bytes a partir do local especificado na matriz de entrada. |