Span<T> 建構函式

定義

命名空間:

System

組件:

System.Runtime.dll

多載

Span<T>(T)	在指定的參考周圍建立長度為1的新 Span<T>。
Span<T>(T[])	在整個指定的陣列上建立新的 Span<T> 物件。
Span<T>(Void*, Int32)	從指定的記憶體位址開始，從指定的 T 項目數目建立新的 Span<T> 物件。
Span<T>(T[], Int32, Int32)	建立新的 Span<T> 物件，其中包含從指定索引開始之陣列的指定項目數。

Span<T>(T)

來源:

Span.cs

在指定的參考周圍建立長度為1的新 Span<T>。

public:
 Span(T % reference);

public Span (ref T reference);

new Span<'T> : 'T -> Span<'T>

Public Sub New (ByRef reference As T)

參數

reference

T

數據的參考。

Span<T>(T[])

來源:

Span.cs

在整個指定的陣列上建立新的 Span<T> 物件。

public:
 Span(cli::array <T> ^ array);

public Span (T[]? array);

new Span<'T> : 'T[] -> Span<'T>

Public Sub New (array As T())

參數

array

T[]

要從中建立 Span<T> 對象的陣列。

例外狀況

ArrayTypeMismatchException

T 是參考型別，array 不是類型 T陣列。

備註

如果 arraynull，這個建構函式會傳回 nullSpan<T>。

Span<T>(Void*, Int32)

來源:

Span.cs

重要

此 API 不符合 CLS 規範。

從指定的記憶體位址開始，從指定的 T 項目數目建立新的 Span<T> 物件。

public:
 Span(void* pointer, int length);

[System.CLSCompliant(false)]
public Span (void* pointer, int length);

[<System.CLSCompliant(false)>]
new Span<'T> : nativeptr<unit> * int -> Span<'T>

參數

pointer

Void*

記憶體中指定 T 項目數目之起始位址的指標。

length

Int32

要包含在 Span<T>中的 T 項目數目。

屬性

CLSCompliantAttribute

例外狀況

ArgumentException

T 是參考型別或包含指標，因此無法儲存在 Unmanaged 記憶體中。

ArgumentOutOfRangeException

length 為負數。

備註

此建構函式應該小心使用，因為它會從 void*型別記憶體區塊建立任意類型 T，而且建構函式不會驗證 pointer 或 length。

Span<T>(T[], Int32, Int32)

來源:

Span.cs

建立新的 Span<T> 物件，其中包含從指定索引開始之陣列的指定項目數。

public:
 Span(cli::array <T> ^ array, int start, int length);

public Span (T[]? array, int start, int length);

new Span<'T> : 'T[] * int * int -> Span<'T>

Public Sub New (array As T(), start As Integer, length As Integer)

參數

array

T[]

來源陣列。

start

Int32

要包含在新 Span<T>中之第一個專案之以零起始的索引。

length

Int32

要包含在新 Span<T>中的項目數目。

例外狀況

ArgumentOutOfRangeException

array 是 null，但 start 或 length 為非零。

-或-

start 超出陣列界限。

-或-

start 和 length 超過陣列中的元素數目。

ArrayTypeMismatchException

T 是參考型別，array 不是類型 T陣列。

備註

當 arraynull時，這個方法會傳回 default。