ReadOnlySpan<T> 建構函式

定義

命名空間:

System

組件:

System.Runtime.dll

套件:

System.Memory v4.5.5

多載

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

ReadOnlySpan<T>(T)

來源:

ReadOnlySpan.cs

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

public:
 ReadOnlySpan(T % reference);

public ReadOnlySpan (ref T reference);

new ReadOnlySpan<'T> : 'T -> ReadOnlySpan<'T>

Public Sub New (ByRef reference As T)

參數

reference

T

資料的參考。

ReadOnlySpan<T>(T[])

來源:

ReadOnlySpan.cs

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

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

public ReadOnlySpan (T[]? array);

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

Public Sub New (array As T())

參數

array

T[]

要從中建立 ReadOnlySpan<T> 的陣列。

備註

如果陣列為 Null，此建構函式會傳回 Null ReadOnlySpan<T>。

ReadOnlySpan<T>(Void*, Int32)

來源:

ReadOnlySpan.cs

重要

此 API 不符合 CLS 規範。

透過指定的 T 元素數目建立新 ReadOnlySpan<T>，從指定的記憶體位址開始。

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

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

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

參數

pointer

Void*

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

length

Int32

要包含在 ReadOnlySpan<T> 中的 T 元素數目。

屬性

CLSCompliantAttribute

例外狀況

ArgumentException

T 是參考型別或包含參考，因此無法儲存在非受控記憶體中。

ArgumentOutOfRangeException

length 為負。

備註

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

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

來源:

ReadOnlySpan.cs

建立新的 ReadOnlySpan<T>，其中包含起始於指定索引之陣列的指定元素數目。

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

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

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

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

參數

array

T[]

要從中建立 ReadOnlySpan<T> 的陣列。

start

Int32

要包括的第一個元素索引。

length

Int32

要包括的元素數目。

例外狀況

ArgumentOutOfRangeException

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

-或-

start 在陣列的界限之外。

-或-

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

備註

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