Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje