SafeBuffer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Precaución
SafeBuffer may be unavailable in future releases.
Proporciona un búfer de memoria controlado que se puede usar para leer y escribir. Los intentos para acceder a la memoria fuera del búfer controlado (agotamientos y saturaciones) provocan excepciones.
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.SafeHandlepublic abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[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.SafeHandle[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandletype SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
[<System.Obsolete("SafeBuffer may be unavailable in future releases.")>]
type SafeBuffer = class
inherit SafeHandlePublic MustInherit Class SafeBuffer
Inherits SafeHandlePublic MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid- Herencia
- Herencia
- Herencia
- Derivado
- Atributos
Comentarios
Debe llamar al SafeBuffer.Initialize método antes de usar cualquier instancia de SafeBuffer. Para evitar carreras al almacenar una instancia de un SafeBuffer objeto en una variable estática, debe usar uno de los métodos siguientes:
Cree un bloqueo al publicar .SafeBuffer
Cree una variable local, inicialice y SafeBuffer, a continuación, asigne a SafeBuffer la variable estática, por ejemplo, mediante el Interlocked.CompareExchange método .
Nota
Las asignaciones de un constructor de clase estática se bloquean implícitamente.
Constructores
| SafeBuffer(Boolean) |
Obsoletos.
Crea una nueva instancia de la clase SafeBuffer y especifica si el identificador del búfer se va a liberar de forma segura. |
Campos
| handle |
Obsoletos.
Especifica el identificador que se va a ajustar. (Heredado de SafeHandle) |
Propiedades
| ByteLength |
Obsoletos.
Obtiene el tamaño del búfer, en bytes. |
| IsClosed |
Obsoletos.
Obtiene un valor que indica si el identificador está cerrado. (Heredado de SafeHandle) |
| IsInvalid |
Obsoletos.
Obtiene un valor que indica si el identificador no es válido. |
| IsInvalid |
Obsoletos.
Obtiene un valor que indica si el identificador no es válido. (Heredado de SafeHandleZeroOrMinusOneIsInvalid) |
Métodos
| AcquirePointer(Byte*) |
Obsoletos.
Obtiene un puntero de un objeto SafeBuffer para un bloque de memoria. |
| Close() |
Obsoletos.
Marca el identificador para soltar y liberar recursos. (Heredado de SafeHandle) |
| DangerousAddRef(Boolean) |
Obsoletos.
Aumenta manualmente el recuento de referencias en instancias de SafeHandle. (Heredado de SafeHandle) |
| DangerousGetHandle() |
Obsoletos.
Devuelve el valor del campo handle. (Heredado de SafeHandle) |
| DangerousRelease() |
Obsoletos.
Disminuye manualmente el recuento de referencias en una instancia de SafeHandle. (Heredado de SafeHandle) |
| Dispose() |
Obsoletos.
Libera todos los recursos que utiliza la clase SafeHandle. (Heredado de SafeHandle) |
| Dispose(Boolean) |
Obsoletos.
Libera los recursos no administrados usados por la clase SafeHandle especificando si se lleva a cabo una operación de eliminación normal. (Heredado de SafeHandle) |
| Equals(Object) |
Obsoletos.
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Obsoletos.
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obsoletos.
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Initialize(UInt32, UInt32) |
Obsoletos.
Especifica el tamaño de asignación del búfer de memoria utilizando el número especificado de elementos y tamaño de elemento. Debe llamar a este método antes de usar la instancia de SafeBuffer. |
| Initialize(UInt64) |
Obsoletos.
Define el tamaño de asignación del área de memoria en bytes. Debe llamar a este método antes de usar la instancia de SafeBuffer. |
| Initialize<T>(UInt32) |
Obsoletos.
Define el tamaño de asignación del área de memoria especificando el número de tipos de valor. Debe llamar a este método antes de usar la instancia de SafeBuffer. |
| MemberwiseClone() |
Obsoletos.
Crea una copia superficial del Object actual. (Heredado de Object) |
| Read<T>(UInt64) |
Obsoletos.
Lee un tipo de valor de la memoria en el desplazamiento especificado. |
| ReadArray<T>(UInt64, T[], Int32, Int32) |
Obsoletos.
Lee el número especificado de tipos de valor de la memoria empezando en el desplazamiento y los escribe en una matriz empezando en el índice. |
| ReadSpan<T>(UInt64, Span<T>) |
Obsoletos.
Lee los tipos de valor de la memoria a partir del desplazamiento y los escribe en un intervalo. El número de tipos de valor que se leerán viene determinado por la longitud del intervalo. |
| ReleaseHandle() |
Obsoletos.
Cuando se invalida en una clase derivada, ejecuta el código necesario para liberar el identificador. (Heredado de SafeHandle) |
| ReleasePointer() |
Obsoletos.
Libera un puntero obtenido por el método AcquirePointer(Byte*). |
| SetHandle(IntPtr) |
Obsoletos.
Establece el identificador en el identificador preexistente. (Heredado de SafeHandle) |
| SetHandleAsInvalid() |
Obsoletos.
Marca un identificador para indicar que ya no se utiliza. (Heredado de SafeHandle) |
| ToString() |
Obsoletos.
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| Write<T>(UInt64, T) |
Obsoletos.
Escribe un tipo de valor en la memoria en la ubicación dada. |
| WriteArray<T>(UInt64, T[], Int32, Int32) |
Obsoletos.
Escribe el número especificado de tipos de valor en una ubicación de memoria leyendo bytes a partir de la ubicación especificada en la matriz de entrada. |
| WriteSpan<T>(UInt64, ReadOnlySpan<T>) |
Obsoletos.
Escribe los tipos de valor de un intervalo de solo lectura en una ubicación de memoria. |
