CKTIS / C#
TextWriter.Write(ReadOnlySpan<char>) — einen Textausschnitt schreiben
TextWriter.Write(ReadOnlySpan<char>) schreibt Zeichen aus einer Speicheransicht, ohne einen Zeilenabschluss anzuhängen. So kann der Aufrufer einen Textausschnitt übergeben, ohne eine Teilzeichenfolge zu erstellen; eine allokationsfreie Verarbeitung innerhalb eines bestimmten Writers ist jedoch nicht garantiert.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public virtual void Write(ReadOnlySpan<char> buffer);TextWriter.Write(ReadOnlySpan<char>) ist eine synchrone, virtuelle Überladung im Namespace System.IO. Sie schreibt die Zeichen aus buffer in den Zieltextstream und gibt void zurück. Anders als WriteLine hängt sie keinen Zeilenabschluss an; außerdem ist sie keine Überladung, die eine Formatzeichenfolge und Argumente entgegennimmt.
ReadOnlySpan<char> ist eine schreibgeschützte Ansicht auf Zeichen. Der Aufruf text.AsSpan(1, 5) wählt fünf Zeichen ab Index 1 aus, ohne eine separate Teilzeichenfolge zu erstellen. Übergib diese Ansicht direkt an Write; ein vorheriger Aufruf von ToString() ist nicht nötig. Index und Länge müssen innerhalb der Grenzen des Textes liegen.
Die Methode ist virtuell: Der Laufzeittyp des Writers bestimmt die Implementierung, auch wenn die Variable als TextWriter typisiert ist. Die Verwendung der Span-Überladung allein garantiert weder, dass der Writer keine Allokationen vornimmt, noch dass er intern nichts kopiert. Unterscheide zwischen dem Vermeiden einer Teilzeichenfolge am Aufrufort und den Kosten des Schreibens ins Ziel.
Diese API ist seit .NET Core 2.1 und in .NET Standard 2.1 verfügbar und bleibt auch in .NET 10 verfügbar; sie ist keine Neuerung von .NET 10. Das Beispiel ist für die Konfiguration des Repositorys mit net10.0 und LangVersion=preview vorgesehen. Es verwendet StringWriter über eine TextWriter-Referenz: Es schreibt den Ausschnitt hello, dann ! und gibt schließlich hello! ohne Zeilenabschluss aus.
Beispiele
using System;
using System.IO;
using StringWriter storage = new StringWriter();
TextWriter writer = storage;
string text = "[hello]";
ReadOnlySpan<char> part = text.AsSpan(1, 5);
writer.Write(part);
writer.Write('!');
Console.Write(storage.ToString());Ergebnis
hello!
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.