WindowsRuntimeBuffer.Create Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Create(Int32) |
Возвращает пустой интерфейс Windows.Storage.Streams.IBuffer, имеющий указанную максимальную емкость. |
Create(Byte[], Int32, Int32, Int32) |
Возвращает интерфейс Windows.Storage.Streams.IBuffer, содержащий указанный диапазон байтов, копируемых из массива байтов. Если указанная емкость превышает количество скопированных байтов, остальная часть буфера заполняется нулями. |
Create(Int32)
Важно!
Этот API несовместим с CLS.
Возвращает пустой интерфейс Windows.Storage.Streams.IBuffer, имеющий указанную максимальную емкость.
public:
static Windows::Storage::Streams::IBuffer ^ Create(int capacity);
[System.CLSCompliant(false)]
public static Windows.Storage.Streams.IBuffer Create (int capacity);
[<System.CLSCompliant(false)>]
static member Create : int -> Windows.Storage.Streams.IBuffer
Public Shared Function Create (capacity As Integer) As IBuffer
Параметры
- capacity
- Int32
Максимальное количество байтов, которое может храниться в буфере.
Возвращаемое значение
Интерфейс Windows.Storage.Streams.IBuffer, который имеет указанную емкость и свойство Length, равное 0 (ноль).
- Атрибуты
Исключения
Значение параметра capacity
меньше 0 (нуля).
Применяется к
Create(Byte[], Int32, Int32, Int32)
Важно!
Этот API несовместим с CLS.
Возвращает интерфейс Windows.Storage.Streams.IBuffer, содержащий указанный диапазон байтов, копируемых из массива байтов. Если указанная емкость превышает количество скопированных байтов, остальная часть буфера заполняется нулями.
public:
static Windows::Storage::Streams::IBuffer ^ Create(cli::array <System::Byte> ^ data, int offset, int length, int capacity);
[System.CLSCompliant(false)]
public static Windows.Storage.Streams.IBuffer Create (byte[] data, int offset, int length, int capacity);
[<System.CLSCompliant(false)>]
static member Create : byte[] * int * int * int -> Windows.Storage.Streams.IBuffer
Public Shared Function Create (data As Byte(), offset As Integer, length As Integer, capacity As Integer) As IBuffer
Параметры
- data
- Byte[]
Массив байтов, из которого необходимо скопировать данные.
- offset
- Int32
Смещение в data
, с которого начинается копирование.
- length
- Int32
Число байт для копирования.
- capacity
- Int32
Максимальное количество байтов, которое может содержать буфер; если это значение больше значения параметра length
, то остальные байты в буфере инициализируются значением 0 (нуль).
Возвращаемое значение
Интерфейс Windows.Storage.Streams.IBuffer, содержащий указанный диапазон байтов. Если capacity
больше length
, остальная часть буфера заполняется нулями.
- Атрибуты
Исключения
Значение параметра capacity
, offset
или length
меньше 0 (нуля).
Параметр data
имеет значение null.
Начиная с offset
, data
не содержит элементов length
. -или- Начиная с offset
, data
не содержит элементов capacity
.