ReadOnlySpan<T> Struct

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

ReadOnlySpan.cs

Fornisce una rappresentazione di sola lettura indipendente dai tipi e sicura per la memoria di un'area contigua di memoria arbitraria.

generic <typename T>
public value class ReadOnlySpan

[System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))]
public readonly ref struct ReadOnlySpan<T>

[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))>]
type ReadOnlySpan<'T> = struct

Public Structure ReadOnlySpan(Of T)

Parametri di tipo

T

Tipo di elementi in ReadOnlySpan<T>.

Ereditarietà

Object

ValueType

ReadOnlySpan<T>

Attributi

NativeMarshallingAttribute

Commenti

ReadOnlySpan<T> è uno struct di riferimento allocato nello stack e non può mai passare all'heap gestito. I tipi di struct ref hanno una serie di restrizioni per garantire che non possano essere promossi all'heap gestito, incluso che non possono essere boxed, acquisiti nelle espressioni lambda, assegnati a variabili di tipo Object, assegnati alle dynamic variabili e non possono implementare alcun tipo di interfaccia.

Un'istanza ReadOnlySpan<T> viene spesso usata per fare riferimento agli elementi di una matrice o di una parte di una matrice. A differenza di una matrice, tuttavia, un'istanza ReadOnlySpan<T> può puntare alla memoria gestita, alla memoria nativa o alla memoria gestita nello stack.

Costruttori

Nome	Descrizione
ReadOnlySpan<T>(T)	Crea un nuovo ReadOnlySpan<T> valore di lunghezza 1 intorno al riferimento specificato.
ReadOnlySpan<T>(T[], Int32, Int32)	Crea un nuovo ReadOnlySpan<T> oggetto che include un numero specificato di elementi di una matrice a partire da un indice specificato.
ReadOnlySpan<T>(T[])	Crea un nuovo ReadOnlySpan<T> oggetto sull'intera matrice specificata.
ReadOnlySpan<T>(Void*, Int32)	Crea un nuovo ReadOnlySpan<T> oggetto da un numero specificato di elementi a partire da un indirizzo di T memoria specificato.

Proprietà

Nome	Descrizione
Empty	Restituisce un oggetto vuoto ReadOnlySpan<T>.
IsEmpty	Restituisce un valore che indica che l'intervallo di sola lettura corrente è vuoto.
Item[Int32]	Ottiene un elemento dall'intervallo di sola lettura in corrispondenza dell'indice in base zero specificato.
Length	Numero di elementi nell'intervallo di sola lettura.

Metodi

Nome	Descrizione
CastUp<TDerived>(ReadOnlySpan<TDerived>)	Esegue il cast di un intervallo di sola lettura di TDerived a un intervallo di sola lettura di T.
CopyTo(Span<T>)	Copia il contenuto di questo ReadOnlySpan<T> oggetto in una destinazione Span<T>.
Equals(Object)	Obsoleti. Non supportato. Genera un oggetto NotSupportedException.
GetEnumerator()	Restituisce un enumeratore per l'oggetto ReadOnlySpan<T>.
GetHashCode()	Obsoleti. Non supportato. Genera un oggetto NotSupportedException.
GetPinnableReference()	Restituisce un riferimento di sola lettura a un oggetto di tipo T che può essere utilizzato per l'aggiunta. Questo metodo è progettato per supportare .NET compilatori e non deve essere chiamato dal codice utente.
Slice(Int32, Int32)	Crea una sezione dall'intervallo di sola lettura corrente a partire da un indice specificato per una lunghezza specificata.
Slice(Int32)	Forma una sezione dall'intervallo di sola lettura corrente che inizia in corrispondenza di un indice specificato.
ToArray()	Copia il contenuto di questo intervallo di sola lettura in una nuova matrice.
ToString()	Restituisce la rappresentazione di stringa di questo ReadOnlySpan<T>oggetto .
TryCopyTo(Span<T>)	Tenta di copiare il contenuto di questo ReadOnlySpan<T> oggetto in un Span<T> oggetto e restituisce un valore per indicare se l'operazione è riuscita o meno.

Operatori

Nome	Descrizione
Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Restituisce un valore che indica se due ReadOnlySpan<T> istanze sono uguali.
Implicit(ArraySegment<T> to ReadOnlySpan<T>)	Definisce una conversione implicita di un oggetto ArraySegment<T> in un oggetto ReadOnlySpan<T>.
Implicit(T[] to ReadOnlySpan<T>)	Definisce una conversione implicita di una matrice in un oggetto ReadOnlySpan<T>.
Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Restituisce un valore che indica se due ReadOnlySpan<T> istanze non sono uguali.

Metodi di estensione

Nome	Descrizione
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	Cerca un intero oggetto ordinato per un valore usando il tipo generico ReadOnlySpan<T> specificato TComparable .
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	Cerca un intero oggetto ordinato ReadOnlySpan<T> per un valore specificato usando il tipo generico specificato TComparer .
BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)	Cerca un intero oggetto ordinato ReadOnlySpan<T> per un valore usando l'interfaccia generica specificata IComparable<T> .
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Determina la lunghezza di qualsiasi prefisso comune condiviso tra span e other.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Trova la lunghezza di qualsiasi prefisso comune condiviso tra span e other.
Contains<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca il valore specificato e restituisce true se trovato. Se non viene trovato, restituisce false.
Contains<T>(ReadOnlySpan<T>, T)	Indica se un valore specificato viene trovato in un intervallo di sola lettura.
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca qualsiasi occorrenza di uno dei valori specificati values e restituisce true se trovato. Se non viene trovato, restituisce false.
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca un'occorrenza di uno qualsiasi degli oggetti specificati values.
ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca un'occorrenza di uno qualsiasi degli oggetti specificati values.
ContainsAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca un'occorrenza di uno dei valori specificati.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca qualsiasi occorrenza dei valori specificati nell'intervallo specificato.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T)	Cerca un'occorrenza di value0, value1o value2 nell'intervallo specificato.
ContainsAny<T>(ReadOnlySpan<T>, T, T)	Cerca un'occorrenza di value0 o value1.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca nell'intervallo specificato qualsiasi valore diverso dall'oggetto specificato values.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca nell'intervallo specificato qualsiasi valore diverso dall'oggetto specificato values.
ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca nell'intervallo specificato qualsiasi valore diverso dall'oggetto specificato values.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca nell'intervallo specificato qualsiasi valore diverso da value.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca qualsiasi valore diverso da value0 o value1.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca qualsiasi valore diverso da value0, value1o value2.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Cerca qualsiasi valore diverso da value0, value1o value2.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)	Cerca qualsiasi valore diverso da value0 o value1nell'intervallo specificato.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T)	Cerca nell'intervallo specificato qualsiasi valore diverso dall'oggetto specificato value.
ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Cerca qualsiasi valore al di fuori dell'intervallo compreso tra lowInclusive e highInclusive, inclusivo.
ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)	Cerca qualsiasi valore nell'intervallo compreso tra lowInclusive e highInclusive, inclusivo.
Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Conta il numero di volte in cui si verifica l'oggetto specificato value nell'oggetto span.
Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Conta il numero di volte value che si verifica in span.
Count<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Conta il numero di volte in cui si verifica l'oggetto specificato value nell'oggetto span.
Count<T>(ReadOnlySpan<T>, T)	Conta il numero di volte in cui si verifica l'oggetto specificato value nell'oggetto span.
CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Conta il numero di volte in cui si verifica uno qualsiasi degli oggetti specificati values nell'oggetto span.
CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Conta il numero di volte in cui si verifica uno qualsiasi degli oggetti specificati values nell'oggetto span.
CountAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Conta il numero di volte in cui si verifica uno qualsiasi degli oggetti specificati values nell'oggetto span.
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Determina se la sequenza specificata viene visualizzata alla fine dell'intervallo di sola lettura.
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se la sequenza specificata viene visualizzata alla fine di un intervallo di sola lettura.
EndsWith<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Determina se il valore specificato viene visualizzato alla fine dell'intervallo.
EndsWith<T>(ReadOnlySpan<T>, T)	Determina se il valore specificato viene visualizzato alla fine dell'intervallo.
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca la sequenza specificata e restituisce l'indice della prima occorrenza.
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca la sequenza specificata e restituisce l'indice della prima occorrenza.
IndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca il valore specificato e restituisce l'indice della prima occorrenza.
IndexOf<T>(ReadOnlySpan<T>, T)	Cerca il valore specificato e restituisce l'indice della prima occorrenza.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Cerca il primo indice di uno dei valori specificati.
IndexOfAny<T>(ReadOnlySpan<T>, T, T)	Cerca il primo indice di uno dei valori specificati.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca il primo indice di qualsiasi valore diverso dall'oggetto specificato values.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca il primo indice di qualsiasi valore diverso dall'oggetto specificato values.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca il primo indice di qualsiasi valore diverso dall'oggetto specificato values.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca il primo indice di qualsiasi valore diverso dall'oggetto specificato value.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca il primo indice di qualsiasi valore diverso dai due valori specificati.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca il primo indice di qualsiasi valore diverso da value0, value1o value2.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Cerca il primo indice di qualsiasi valore diverso da value0, value1o value2.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Cerca il primo indice di qualsiasi valore diverso dai due valori specificati.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Cerca il primo indice di qualsiasi valore diverso dall'oggetto specificato value.
IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Cerca il primo indice di qualsiasi valore al di fuori dell'intervallo tra lowInclusive e highInclusive, inclusivo.
IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Cerca il primo indice di qualsiasi valore nell'intervallo compreso tra lowInclusive e highInclusive, inclusi.
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca la sequenza specificata e restituisce l'indice dell'ultima occorrenza. Se non viene trovato, restituisce -1.
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca la sequenza specificata e restituisce l'indice dell'ultima occorrenza.
LastIndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca il valore specificato e restituisce l'indice dell'ultima occorrenza. Se non viene trovato, restituisce -1.
LastIndexOf<T>(ReadOnlySpan<T>, T)	Cerca il valore specificato e restituisce l'indice dell'ultima occorrenza.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T)	Cerca l'ultimo indice di uno dei valori specificati.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato values.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato values.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato values.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato value.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato value0 o value1.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Cerca l'ultimo indice di qualsiasi valore diverso da , value1o value2specificatovalue0.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Cerca l'ultimo indice di qualsiasi valore diverso da , value1o value2specificatovalue0.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato value0 o value1.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Cerca l'ultimo indice di qualsiasi valore diverso dall'oggetto specificato value.
LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Cerca l'ultimo indice di qualsiasi valore al di fuori dell'intervallo tra lowInclusive e highInclusive, inclusivo.
LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Cerca l'ultimo indice di qualsiasi valore nell'intervallo compreso tra lowInclusive e highInclusive, inclusi.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)	Determina se due sequenze di sola lettura si sovrappongono in memoria e restituisce l'offset dell'elemento.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se due sequenze di sola lettura si sovrappongono in memoria.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T, IEqualityComparer<T>)	Copia source in destination, sostituendo tutte le occorrenze di oldValue con newValue.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)	Copia source in destination, sostituendo tutte le occorrenze di oldValue con newValue.
ReplaceAny<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)	Copia source in destination, sostituendo tutte le occorrenze di uno qualsiasi degli elementi in values con newValue.
ReplaceAnyExcept<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)	Copia source in destination, sostituendo tutte le occorrenze di uno qualsiasi degli elementi diversi da quelli in values con newValue.
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IComparer<T>)	Determina l'ordine relativo delle sequenze confrontate confrontando gli elementi usando IComparable{T}. CompareTo(T).
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina l'ordine relativo di due sequenze di sola lettura confrontando i relativi elementi usando IComparable{T}. CompareTo(T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Determina se due sequenze sono uguali confrontando gli elementi usando un oggetto IEqualityComparer<T>.
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se due sequenze di sola lettura sono uguali confrontando gli elementi usando IEquatable{T}. Equals(T).
Split<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Restituisce un tipo che consente l'enumerazione di ogni elemento all'interno di un intervallo di divisione utilizzando l'intervallo di separatore specificato.
Split<T>(ReadOnlySpan<T>, T)	Restituisce un tipo che consente l'enumerazione di ogni elemento all'interno di un intervallo di divisione utilizzando il carattere separatore specificato.
SplitAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Restituisce un tipo che consente l'enumerazione di ogni elemento all'interno di un intervallo di divisione utilizzando uno degli elementi forniti.
SplitAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Restituisce un tipo che consente l'enumerazione di ogni elemento all'interno di un intervallo di divisione utilizzando i caratteri separatori specificati.
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Determina se una sequenza specificata viene visualizzata all'inizio di un intervallo di sola lettura.
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se una sequenza specificata viene visualizzata all'inizio di un intervallo di sola lettura.
StartsWith<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Determina se il valore specificato viene visualizzato all'inizio dell'intervallo.
StartsWith<T>(ReadOnlySpan<T>, T)	Determina se il valore specificato viene visualizzato all'inizio dell'intervallo.
ToImmutableArray<T>(ReadOnlySpan<T>)	Produrre una matrice di contenuti non modificabile dagli elementi specificati.
Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Rimuove tutte le occorrenze iniziali e finali di un set di elementi specificato in un intervallo di sola lettura da un intervallo di sola lettura.
Trim<T>(ReadOnlySpan<T>, T)	Rimuove tutte le occorrenze iniziali e finali di un elemento specificato da un intervallo di sola lettura.
TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Rimuove tutte le occorrenze finali di un set di elementi specificato in un intervallo di sola lettura da un intervallo di sola lettura.
TrimEnd<T>(ReadOnlySpan<T>, T)	Rimuove tutte le occorrenze finali di un elemento specificato da un intervallo di sola lettura.
TrimStart<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Rimuove tutte le occorrenze iniziali di un set di elementi specificato in un intervallo di sola lettura dall'intervallo.
TrimStart<T>(ReadOnlySpan<T>, T)	Rimuove tutte le occorrenze iniziali di un elemento specificato dall'intervallo.

Vedi anche

• Tipi correlati alla memoria e all'intervallo
• Linee guida per l'utilizzo della memoria<T> e dell'intervallo<T>