語言

Span<T> 建構函式

定義

多載

名稱 Description
Span<T>(T)

建立一個長度為 1 的新 Span<T> 參考,圍繞指定的參考。

Span<T>(T[])

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

Span<T>(Void*, Int32)

從指定記憶體位址開始的指定元素Span<T>數量建立一個新T物件。

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

建立一個新 Span<T> 物件,包含從指定索引開始的陣列元素數量。

Span<T>(T)

來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
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.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs

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

public:
 Span(cli::array <T> ^ array);
public Span(T[]? array);
public Span(T[] array);
new Span<'T> : 'T[] -> Span<'T>
Public Sub New (array As T())

參數

array
T[]

用來建立 Span<T> 物件的陣列。

例外狀況

T 是參考型別,且 array 不是型別 T為 的陣列。

備註

若 array ,null則此構造子回傳 。nullSpan<T>

適用於

Span<T>(Void*, Int32)

來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs

重要

此 API 不符合 CLS 規範。

從指定記憶體位址開始的指定元素Span<T>數量建立一個新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

T要包含在 Span<T>.

屬性

例外狀況

T 是參考型別或包含指標,因此無法儲存在非管理記憶體中。

length 為負數。

備註

此建構子應謹慎使用,因為它從 -型別的記憶體區塊中產生任意型別 T的 s void*,且建 pointer 構子不會驗證 或 length 。

適用於

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

來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs
來源:
Span.cs

建立一個新 Span<T> 物件,包含從指定索引開始的陣列元素數量。

public:
 Span(cli::array <T> ^ array, int start, int length);
public Span(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>. 中要包含的元素數量。

例外狀況

array 是 null,但 start 或 length 非零。

-或-

start 不在陣列的範圍之外。

-或-

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

T 是參考型別,且 array 不是型別 T為 的陣列。

備註

此方法在 default 為 時array回傳null。

適用於