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 型別的陣列。

備註

如果 為 nullarray ，這個建構函式會傳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 是參考型別或包含指標，因此無法儲存在非受控記憶體中。

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 型別的陣列。

備註

當 為 null時array，這個方法會傳default回 。