Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła