SafeBuffer Класс

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.dll

Исходный код:

SafeBuffer.cs

Предоставляет управляемый буфер памяти, который может использоваться для чтения и записи. Попытки обращения к памяти за пределами управляемого буфера (опустошение или переполнение) вызывают исключения.

public ref class SafeBuffer abstract : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid

public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid

type SafeBuffer = class
    inherit SafeHandleZeroOrMinusOneIsInvalid

Public MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid

Наследование

Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid

SafeBuffer

Производный

Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle

Комментарии

Перед использованием любого экземпляра SafeBufferнеобходимо вызвать SafeBuffer.Initialize метод . Чтобы избежать рас при хранении экземпляра SafeBuffer объекта в статической переменной, следует использовать один из следующих подходов:

• Создайте блокировку при публикации SafeBuffer.

• Создайте локальную переменную, инициализируйте SafeBuffer, а затем назначьте SafeBuffer статическую переменную, например с помощью Interlocked.CompareExchange метода .

Примечание

Назначения в конструкторе статических классов неявно блокируются.

Конструкторы

SafeBuffer(Boolean)

Создает новый экземпляр класса SafeBuffer и указывает, должен ли быть дескриптор буфера надежно освобожден.

Поля

handle

Определяет инкапсулируемый дескриптор. (Унаследовано от SafeHandle)

Свойства

ByteLength	Получает размер буфера (в байтах).
IsClosed	Возвращает значение, показывающее, является ли дескриптор закрытым. (Унаследовано от SafeHandle)
IsInvalid	Получает значение, указывающее, является ли дескриптор недействительным. (Унаследовано от SafeHandleZeroOrMinusOneIsInvalid)

Методы

AcquirePointer(Byte*)	Получает из объекта SafeBuffer указатель для блока памяти.
Close()	Помечает дескриптор для освобождения самого дескриптора и соответствующих ресурсов. (Унаследовано от SafeHandle)
DangerousAddRef(Boolean)	Вручную увеличивает счетчик ссылок для экземпляров SafeHandle. (Унаследовано от SafeHandle)
DangerousGetHandle()	Возвращает значение поля handle. (Унаследовано от SafeHandle)
DangerousRelease()	Вручную уменьшает счетчик ссылок для экземпляра SafeHandle. (Унаследовано от SafeHandle)
Dispose()	Освобождает все ресурсы, используемые классом SafeHandle. (Унаследовано от SafeHandle)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые классом SafeHandle, определяя, нужно ли выполнять обычную операцию удаления. (Унаследовано от SafeHandle)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Initialize(UInt32, UInt32)	Задает размер выделяемого буфера памяти, используя указанное количество элементов и размер элемента. Данный метод необходимо вызвать перед использованием экземпляра SafeBuffer.
Initialize(UInt64)	Определяет размер выделяемой области памяти (в байтах). Данный метод необходимо вызвать перед использованием экземпляра SafeBuffer.
Initialize<T>(UInt32)	Определяет размер выделяемой области памяти путем указания количества значений и их типа. Данный метод необходимо вызвать перед использованием экземпляра SafeBuffer.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Read<T>(UInt64)	Считывает из памяти тип значения с указанным смещением.
ReadArray<T>(UInt64, T[], Int32, Int32)	Считывает из памяти указанное количество типов значений, начиная указанного смещения, и записывает их в массив, начиная с указанного индекса.
ReadSpan<T>(UInt64, Span<T>)	Считывает типы значений из памяти, начиная со смещения, и записывает их в диапазон. Количество типов значений, которые будут считываться, определяется длиной диапазона.
ReleaseHandle()	При переопределении в производном классе выполняет код, необходимый для освобождения дескриптора. (Унаследовано от SafeHandle)
ReleasePointer()	Высвобождает указатель, полученный методом AcquirePointer(Byte*).
SetHandle(IntPtr)	Определяет дескриптор для заданного ранее существующего дескриптора. (Унаследовано от SafeHandle)
SetHandleAsInvalid()	Помечает дескриптор как больше не используемый. (Унаследовано от SafeHandle)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Write<T>(UInt64, T)	Записывает тип значения в память в указанном расположении.
WriteArray<T>(UInt64, T[], Int32, Int32)	Записывает указанное количество типов значений в указанное расположение в памяти, считывая байты входного массива, начиная с указанного расположения.
WriteSpan<T>(UInt64, ReadOnlySpan<T>)	Записывает типы значений из диапазона только для чтения в расположение в памяти.