NativeMemory.Alloc 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Alloc(UIntPtr) |
分配指定大小的記憶體區塊，以位元組為單位。 |
| Alloc(UIntPtr, UIntPtr) |
以元素分配指定大小的記憶體區塊。 |
Alloc(UIntPtr)
重要
此 API 不符合 CLS 規範。
分配指定大小的記憶體區塊，以位元組為單位。
public:
static void* Alloc(UIntPtr byteCount);[System.CLSCompliant(false)]
public static void* Alloc(UIntPtr byteCount);[System.CLSCompliant(false)]
public static void* Alloc(nuint byteCount);[<System.CLSCompliant(false)>]
static member Alloc : unativeint -> nativeptr<unit>參數
- byteCount
-
UIntPtr
nuint
unativeint
分配區塊的大小（以位元組為單位）。
傳回
Void*
指向已分配記憶體區塊的指標。
- 屬性
例外狀況
byteCount記憶體分配失敗了。
備註
此方法允許 byteCount 且 0 會回傳一個有效的指標，該指標不應被取消引用，且應傳遞給 free，以避免記憶體洩漏。
此方法是 C malloc API 上的薄包裝。
適用於
Alloc(UIntPtr, UIntPtr)
重要
此 API 不符合 CLS 規範。
以元素分配指定大小的記憶體區塊。
public:
static void* Alloc(UIntPtr elementCount, UIntPtr elementSize);[System.CLSCompliant(false)]
public static void* Alloc(UIntPtr elementCount, UIntPtr elementSize);[System.CLSCompliant(false)]
public static void* Alloc(nuint elementCount, nuint elementSize);[<System.CLSCompliant(false)>]
static member Alloc : unativeint * unativeint -> nativeptr<unit>參數
- elementCount
-
UIntPtr
nuint
unativeint
分配區塊的元素數。
- elementSize
-
UIntPtr
nuint
unativeint
配置中每個元素的大小（以位元組為單位）。
傳回
Void*
指向已分配記憶體區塊的指標。
- 屬性
例外狀況
記憶體 elementCount * elementSize 分配位元組失敗了。
備註
此方法允許elementCount且/或elementSize0為且會回傳一個有效的指標，該指標不應被取消引用，且應傳遞為空缺指標以避免記憶體洩漏。
此方法是 C malloc API 上的薄包裝。
