Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

TextWriter.Write(ReadOnlySpan<char>) — zapis dela besedila

TextWriter.Write(ReadOnlySpan<char>) zapiše znake iz pomnilniškega pogleda, ne da bi dodal zaključek vrstice. Klicatelj lahko tako posreduje del besedila brez ustvarjanja podniza, vendar to ne zagotavlja zapisovanja brez alokacij v konkretnem writerju.

Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

public virtual void Write(ReadOnlySpan<char> buffer);

TextWriter.Write(ReadOnlySpan<char>) je sinhrona navidezna preobremenitev v imenskem prostoru System.IO. Zapiše znake iz buffer v ciljni besedilni tok in vrne void. Za razliko od WriteLine ne doda zaključka vrstice; prav tako ne gre za preobremenitev, ki sprejema oblikovni niz in argumente.

ReadOnlySpan<char> je pogled na znake, ki je samo za branje. Klic text.AsSpan(1, 5) izbere pet znakov od indeksa 1, ne da bi ustvaril ločen podniz. Ta pogled posreduj neposredno metodi Write; predhodni klic ToString() ni potreben. Indeks in dolžina morata biti znotraj meja besedila.

Metoda je navidezna: izvedbo določa dejanski tip writerja, tudi kadar je spremenljivka tipa TextWriter. Sama uporaba preobremenitve s spanom ne zagotavlja, da writer ne izvaja alokacij ali notranjega kopiranja. Loči med izogibanjem podnizu na mestu klica in stroškom zapisovanja na cilj.

Ta API je na voljo od .NET Core 2.1 in v .NET Standard 2.1 ter je še vedno na voljo v .NET 10; ni novost .NET 10. Primer je namenjen konfiguraciji repozitorija net10.0 in LangVersion=preview. Uporablja StringWriter prek reference TextWriter: zapiše del hello, nato ! in na koncu izpiše hello! brez zaključka vrstice.

Primeri

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());

Rezultat

hello!

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri