Span<T> Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

Span<T>(T)	Cria um novo Span<T> de comprimento 1 em torno da referência especificada.
Span<T>(T[])	Cria um novo objeto Span<T> sobre a totalidade de uma matriz especificada.
Span<T>(Void*, Int32)	Cria um novo Span<T> objeto com base em um número especificado de T elementos começando em um endereço de memória especificado.
Span<T>(T[], Int32, Int32)	Cria um novo objeto Span<T> que inclui um número especificado de elementos de uma matriz, começando em um índice especificado.

Span<T>(T)

Origem:

Span.cs

Cria um novo Span<T> de comprimento 1 em torno da referência especificada.

public:
 Span(T % reference);

public Span (ref T reference);

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

Public Sub New (ByRef reference As T)

Parâmetros

reference

T

Uma referência aos dados.

Span<T>(T[])

Origem:

Span.cs

Cria um novo objeto Span<T> sobre a totalidade de uma matriz especificada.

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

public Span (T[]? array);

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

Public Sub New (array As T())

Parâmetros

array

T[]

A matriz com base na qual criar o objeto Span<T>.

Exceções

ArrayTypeMismatchException

T é um tipo de referência, e array não é uma matriz do tipo T.

Comentários

Se array for null, esse construtor retornará um nullSpan<T>.

Span<T>(Void*, Int32)

Origem:

Span.cs

Importante

Esta API não está em conformidade com CLS.

Cria um novo Span<T> objeto com base em um número especificado de T elementos começando em um endereço de memória especificado.

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>

Parâmetros

pointer

Void*

Um ponteiro para o endereço inicial de um número especificado de elementos T na memória.

length

Int32

O número de elementos T a serem incluídos no Span<T>.

Atributos

CLSCompliantAttribute

Exceções

ArgumentException

T é um tipo de referência ou contém ponteiros e, portanto, não pode ser armazenado na memória não gerenciada.

ArgumentOutOfRangeException

length é negativo.

Comentários

Esse construtor deve ser usado com cuidado, pois cria s de tipo Tarbitrário a partir de um void*bloco de memória tipado por - e nem nem pointerlength são validados pelo construtor.

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

Origem:

Span.cs

Cria um novo objeto Span<T> que inclui um número especificado de elementos de uma matriz, começando em um índice especificado.

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)

Parâmetros

array

T[]

A matriz de origem.

start

Int32

O índice do primeiro elemento a ser incluído no novo Span<T>.

length

Int32

O número de elementos a serem incluídos no novo Span<T>.

Exceções

ArgumentOutOfRangeException

array é null, mas start ou length é diferente de zero.

- ou -

start está fora dos limites da matriz.

- ou -

start e length excedem o número de elementos da matriz.

ArrayTypeMismatchException

T é um tipo de referência, e array não é uma matriz do tipo T.

Comentários

Esse método retorna default quando array é null.