CKTIS / C#
TextWriter.Write(ReadOnlySpan<char>) — zápis části textu
TextWriter.Write(ReadOnlySpan<char>) zapisuje znaky z pohledu do paměti, aniž by připojila ukončení řádku. Volající tak může předat část textu bez vytvoření podřetězce, nezaručuje to však zápis bez alokací uvnitř konkrétního writeru.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public virtual void Write(ReadOnlySpan<char> buffer);TextWriter.Write(ReadOnlySpan<char>) je synchronní virtuální přetížení v oboru názvů System.IO. Zapisuje znaky z buffer do cílového textového proudu a vrací void. Na rozdíl od WriteLine nepřipojuje ukončení řádku; nejde ani o přetížení, které přijímá formátovací řetězec a argumenty.
ReadOnlySpan<char> je pohled na znaky pouze pro čtení. Volání text.AsSpan(1, 5) vybere pět znaků od indexu 1, aniž by vytvořilo samostatný podřetězec. Tento pohled předej přímo metodě Write; předchozí volání ToString() není potřeba. Index a délka musí být v mezích textu.
Metoda je virtuální: implementaci určuje skutečný typ writeru, i když má proměnná typ TextWriter. Samotné použití přetížení se spanem nezaručuje, že writer neprovádí alokace ani interní kopírování. Rozlišuj mezi vynecháním podřetězce na straně volajícího a náklady na zápis do cíle.
Toto API je dostupné od .NET Core 2.1 a v .NET Standard 2.1 a zůstává dostupné v .NET 10; nejde o novinku .NET 10. Příklad je určen pro konfiguraci repozitáře net10.0 a LangVersion=preview. Používá StringWriter přes referenci TextWriter: zapíše část hello, potom ! a nakonec vypíše hello! bez ukončení řádku.
Příklady
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());Výsledek
hello!
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.