Span<T> Struktur

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Source:: Span.cs

Source:: Span.cs

Source:: Span.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet eine typsichere und speichersichere Darstellung eines zusammenhängenden Bereichs mit beliebigem Arbeitsspeicher.

generic <typename T>
public value class Span

public readonly ref struct Span<T>

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

type Span<'T> = struct

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

Public Structure Span(Of T)

Typparameter

T

Der Typ der Elemente in .Span<T>

Vererbung: Object

ValueType
Span<T>

Attribute: NativeMarshallingAttribute

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für Span<T>.

Konstruktoren

Span<T>(T)	Erstellt einen neuen Span<T> mit der Länge 1 um den angegebenen Verweis.
Span<T>(T[])	Erstellt ein neues Span<T>-Objekt über das gesamte angegebene Array.
Span<T>(T[], Int32, Int32)	Erstellt ein neues Span<T>-Objekt, das eine angegebene Anzahl von Elementen aus einem Array enthält. Dabei wird an einem angegebenen Index begonnen.
Span<T>(Void*, Int32)	Erstellt ein neues Span<T> -Objekt aus einer angegebenen Anzahl von `T` Elementen, beginnend bei einer angegebenen Speicheradresse.

Eigenschaften

Empty	Gibt ein leeres Span<T>-Objekt zurück.
IsEmpty	Gibt einen Wert zurück, der angibt, ob das aktuelle Span<T>-Element leer ist.
Item[Int32]	Ruft das Element am angegebenen nullbasierten Index ab.
Length	Gibt die Länge des aktuellen Span-Elements fest.

Methoden

Clear()	Löscht den Inhalt dieses Span<T>-Objekts.
CopyTo(Span<T>)	Kopiert die Inhalte dieses Span<T>-Elements in ein Span<T>-Zielelement.
Equals(Object)	Veraltet. Veraltet. Das Aufrufen dieser Methode wird nicht unterstützt.
Fill(T)	Füllt die Elemente dieses Span-Elements mit einem angegebenen Wert auf.
GetEnumerator()	Gibt einen Enumerator für dieses Span<T>-Element zurück.
GetHashCode()	Veraltet. Löst eine NotSupportedException aus.
GetPinnableReference()	Gibt einen Verweis auf ein Objekt vom Typ T zurück, das zum Anheften verwendet werden kann. Diese Methode dient zur Unterstützung von .NET-Compilern und ist nicht für den Aufruf durch Benutzercode vorgesehen.
Slice(Int32)	Bildet einen Slice aus dem aktuellen Span-Element, das an einem angegebenen Index beginnt.
Slice(Int32, Int32)	Bildet einen Slice aus dem aktuellen Span-Element. Dabei wird an einem angegebenen Index für eine angegebene Länge begonnen.
ToArray()	Kopiert die Inhalte dieses Span-Elements in ein neues Array.
ToString()	Gibt die Zeichenfolgendarstellung dieses Span<T>-Objekts zurück.
TryCopyTo(Span<T>)	Versucht, das aktuelle Span<T>-Element in ein Span<T>-Zielelement zu kopieren und gibt einen Wert zurück, der angibt, ob der Kopiervorgang erfolgreich war.

Operatoren

Equality(Span<T>, Span<T>)	Gibt einen Wert zurück, der angibt, ob zwei Span<T>-Objekte gleich sind.
Implicit(ArraySegment<T> to Span<T>)	Definiert eine implizite Konvertierung von ArraySegment<T> in Span<T>.
Implicit(Span<T> to ReadOnlySpan<T>)	Definiert eine implizite Konvertierung von Span<T> in ReadOnlySpan<T>.
Implicit(T[] to Span<T>)	Definiert eine implizite Konvertierung eines Arrays in Span<T>.
Inequality(Span<T>, Span<T>)	Gibt einen Wert zurück, der angibt, ob zwei Span<T>-Objekte ungleich sind.

Erweiterungsmethoden

ToImmutableArray<T>(Span<T>)	Konvertiert die Spanne in ein unveränderliches Array.
BinarySearch<T>(Span<T>, IComparable<T>)	Durchsucht ein ganzes sortiertes Span<T> mithilfe der angegebenen generischen IComparable<T>-Schnittstelle nach einem Wert.
BinarySearch<T,TComparer>(Span<T>, T, TComparer)	Durchsucht ein ganzes sortiertes Span<T> mithilfe des angegebenen generischen `TComparer`-Typs nach einem angegebenen Wert.
BinarySearch<T,TComparable>(Span<T>, TComparable)	Durchsucht ein ganzes sortiertes Span<T> mithilfe des angegebenen generischen `TComparable`-Typs nach einem Wert.
CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach der Länge eines gemeinsamen Präfixes, das zwischen `span` und `other`gemeinsam verwendet wird.
CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Sucht nach der Länge eines gemeinsamen Präfixes, das zwischen `span` und `other`gemeinsam verwendet wird.
Contains<T>(Span<T>, T)	Gibt an, ob ein angegebener Wert in einer Spanne gefunden wird. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.
ContainsAny<T>(Span<T>, T, T)	Sucht nach einem Vorkommen von `value0` oder und `value1`gibt zurück `true` , wenn gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben `false`.
ContainsAny<T>(Span<T>, T, T, T)	Sucht nach einem Vorkommen von `value0`, `value1`oder `value2`, und gibt zurück `true` , wenn gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben `false`.
ContainsAny<T>(Span<T>, SearchValues<T>)	Sucht nach einem Vorkommen eines der angegebenen `values` und gibt zurück `true` , falls gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben `false`.
ContainsAny<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach einem Vorkommen eines der angegebenen `values` und gibt zurück `true` , falls gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben `false`.
ContainsAnyExcept<T>(Span<T>, T)	Sucht nach einem anderen Wert als dem angegebenen `value`.
ContainsAnyExcept<T>(Span<T>, T, T)	Sucht nach einem anderen Wert als `value0` oder `value1`.
ContainsAnyExcept<T>(Span<T>, T, T, T)	Sucht nach einem anderen Wert als `value0`, `value1`oder `value2`.
ContainsAnyExcept<T>(Span<T>, SearchValues<T>)	Sucht nach einem anderen Wert als dem angegebenen `values`.
ContainsAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach einem anderen Wert als dem angegebenen `values`.
ContainsAnyExceptInRange<T>(Span<T>, T, T)	Sucht nach einem Beliebigen Wert außerhalb des Bereichs zwischen `lowInclusive` und , `highInclusive`inklusive.
ContainsAnyInRange<T>(Span<T>, T, T)	Sucht nach einem beliebigen Wert im Bereich zwischen `lowInclusive` und , `highInclusive`inklusive, und gibt zurück `true` , wenn er gefunden wird. Wenn sie nicht gefunden wird, wird zurückgegeben `false`.
Count<T>(Span<T>, T)	Zählt, wie oft die angegebene `value` in der `span`auftritt.
Count<T>(Span<T>, ReadOnlySpan<T>)	Zählt, wie oft die angegebene `value` in der `span`auftritt.
EndsWith<T>(Span<T>, ReadOnlySpan<T>)	Bestimmt, ob die angegebene Sequenz am Ende einer Spanne angezeigt wird.
IndexOf<T>(Span<T>, T)	Sucht nach dem angegebenen Wert und gibt den Index des ersten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.
IndexOf<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach der angegebenen Sequenz und gibt den Index des ersten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.
IndexOfAny<T>(Span<T>, T, T)	Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).
IndexOfAny<T>(Span<T>, T, T, T)	Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).
IndexOfAny<T>(Span<T>, SearchValues<T>)	Sucht nach dem ersten Index eines der angegebenen Werte.
IndexOfAny<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).
IndexOfAnyExcept<T>(Span<T>, T)	Sucht nach dem ersten Index eines anderen Werts als dem angegebenen `value`.
IndexOfAnyExcept<T>(Span<T>, T, T)	Sucht nach dem ersten Index eines anderen Werts als dem angegebenen `value0` oder `value1`.
IndexOfAnyExcept<T>(Span<T>, T, T, T)	Sucht nach dem ersten Index eines anderen Werts als dem angegebenen `value0`, `value1`oder `value2`.
IndexOfAnyExcept<T>(Span<T>, SearchValues<T>)	Sucht nach dem ersten Index eines anderen Werts als dem angegebenen `values`.
IndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach dem ersten Index eines anderen Werts als dem angegebenen `values`.
IndexOfAnyExceptInRange<T>(Span<T>, T, T)	Sucht nach dem ersten Index eines beliebigen Werts außerhalb des Bereichs zwischen `lowInclusive` und , `highInclusive`einschließlich.
IndexOfAnyInRange<T>(Span<T>, T, T)	Sucht nach dem ersten Index eines beliebigen Werts im Bereich zwischen `lowInclusive` und , `highInclusive`einschließlich.
LastIndexOf<T>(Span<T>, T)	Sucht nach dem angegebenen Wert und gibt den Index des letzten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.
LastIndexOf<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach der angegebenen Sequenz und gibt den Index des letzten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.
LastIndexOfAny<T>(Span<T>, T, T)	Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).
LastIndexOfAny<T>(Span<T>, T, T, T)	Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).
LastIndexOfAny<T>(Span<T>, SearchValues<T>)	Sucht nach dem letzten Index eines der angegebenen Werte.
LastIndexOfAny<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).
LastIndexOfAnyExcept<T>(Span<T>, T)	Sucht nach dem letzten Index eines anderen Werts als dem angegebenen `value`.
LastIndexOfAnyExcept<T>(Span<T>, T, T)	Sucht nach dem letzten Index eines anderen Werts als dem angegebenen `value0` oder `value1`.
LastIndexOfAnyExcept<T>(Span<T>, T, T, T)	Sucht nach dem letzten Index eines anderen Werts als dem angegebenen `value0`, `value1`oder `value2`.
LastIndexOfAnyExcept<T>(Span<T>, SearchValues<T>)	Sucht nach dem letzten Index eines anderen Werts als dem angegebenen `values`.
LastIndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Sucht nach dem letzten Index eines anderen Werts als dem angegebenen `values`.
LastIndexOfAnyExceptInRange<T>(Span<T>, T, T)	Sucht nach dem letzten Index eines Beliebigen Werts außerhalb des Bereichs zwischen `lowInclusive` und , `highInclusive`inklusive.
LastIndexOfAnyInRange<T>(Span<T>, T, T)	Sucht nach dem letzten Index eines beliebigen Werts im Bereich zwischen `lowInclusive` und , `highInclusive`einschließlich.
Overlaps<T>(Span<T>, ReadOnlySpan<T>)	Bestimmt, ob sich eine Spanne und eine schreibgeschützte Spanne im Speicher überlappen.
Overlaps<T>(Span<T>, ReadOnlySpan<T>, Int32)	Bestimmt, ob sich eine Spanne und eine schreibgeschützte Spanne im Speicher überlappen, und gibt den Elementoffset aus.
Replace<T>(Span<T>, T, T)	Diese Funktion ersetzt alle Vorkommen von `oldValue` durch `newValue`.
Reverse<T>(Span<T>)	Kehrt die Reihenfolge der Elemente in der gesamten Spanne um.
SequenceCompareTo<T>(Span<T>, ReadOnlySpan<T>)	Bestimmt die relative Reihenfolge von einer Spanne und einer schreibgeschützten Spanne durch Vergleichen der Elemente mit „IComparable{T}.CompareTo(T)“.
SequenceEqual<T>(Span<T>, ReadOnlySpan<T>)	Bestimmt, ob eine Spanne und eine schreibgeschützte Spanne identisch sind, indem die Elemente mit „IEquatable{T}.Equals(T)“ verglichen werden.
SequenceEqual<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Bestimmt, ob zwei Sequenzen gleich sind, indem die Elemente mit einem IEqualityComparer<T>verglichen werden.
Sort<T>(Span<T>)	Sortiert die Elemente im Gesamten Span<T> mithilfe der IComparable<T> Implementierung jedes Elements von Span<T>.
Sort<T>(Span<T>, Comparison<T>)	Sortiert die Elemente in der gesamten Span<T> mithilfe des angegebenen Comparison<T>.
Sort<T,TComparer>(Span<T>, TComparer)	Sortiert die Elemente innerhalb von Span<T> mithilfe von `TComparer`.
Sort<TKey,TValue>(Span<TKey>, Span<TValue>)	Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe der IComparable<T>-Implementierung der einzelnen Schlüssel.
Sort<TKey,TValue>(Span<TKey>, Span<TValue>, Comparison<TKey>)	Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe des angegebenen Vergleichs.
Sort<TKey,TValue,TComparer>(Span<TKey>, Span<TValue>, TComparer)	Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe der angegebenen Vergleichsfunktion.
StartsWith<T>(Span<T>, ReadOnlySpan<T>)	Bestimmt, ob eine angegebene Sequenz am Anfang einer Spanne angezeigt wird.
Trim<T>(Span<T>, T)	Entfernt alle führenden und nachfolgenden Vorkommen eines angegebenen Elements aus einer Spanne.
Trim<T>(Span<T>, ReadOnlySpan<T>)	Entfernt alle führenden und nachfolgenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus einer Spanne.
TrimEnd<T>(Span<T>, T)	Entfernt alle nachfolgenden Vorkommen eines angegebenen Elements aus einer Spanne.
TrimEnd<T>(Span<T>, ReadOnlySpan<T>)	Entfernt alle nachfolgenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus einer Spanne.
TrimStart<T>(Span<T>, T)	Entfernt alle führenden Vorkommen eines bestimmten Elements aus der Spanne.
TrimStart<T>(Span<T>, ReadOnlySpan<T>)	Entfernt alle führenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus der Spanne.

Gilt für: