CKTIS / C#
TextWriter.Write(ReadOnlySpan<char>) — zapis fragmentu tekstu
TextWriter.Write(ReadOnlySpan<char>) zapisuje znaki z przekazanego widoku pamięci bez dopisywania końca wiersza. Pozwala przekazać fragment tekstu bez tworzenia podciągu przez wywołującego, ale nie gwarantuje zapisu bez alokacji wewnątrz konkretnego writera.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
public virtual void Write(ReadOnlySpan<char> buffer);TextWriter.Write(ReadOnlySpan<char>) to synchroniczne, wirtualne przeciążenie z przestrzeni nazw System.IO. Zapisuje znaki z buffer do docelowego strumienia tekstowego i zwraca void. W przeciwieństwie do WriteLine nie dopisuje końca wiersza; nie jest też przeciążeniem przyjmującym tekst formatujący i argumenty.
ReadOnlySpan<char> jest widokiem znaków tylko do odczytu. Wywołanie text.AsSpan(1, 5) wybiera pięć znaków od indeksu 1, bez tworzenia osobnego podciągu. Przekaż ten widok bezpośrednio do Write; wcześniejsze wywołanie ToString() nie jest potrzebne. Indeks i długość muszą mieścić się w granicach tekstu.
Metoda jest wirtualna: rzeczywisty typ writera określa implementację, również gdy zmienna ma typ TextWriter. Samo użycie przeciążenia ze spanem nie gwarantuje braku alokacji ani kopiowania wewnątrz writera. Oddziel korzyść z uniknięcia podciągu po stronie wywołującego od kosztu zapisu do miejsca docelowego.
To API jest dostępne od .NET Core 2.1 oraz w .NET Standard 2.1 i pozostaje dostępne w .NET 10; nie jest nowością .NET 10. Przykład jest przeznaczony dla repozytorium z net10.0 i LangVersion=preview. Używa StringWriter przez referencję TextWriter: zapisuje fragment hello, następnie !, a na końcu wypisuje hello! bez końca wiersza.
Przykłady
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());Wynik
hello!
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.