KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

TextWriter.Write(ReadOnlySpan<char>) — een tekstfragment schrijven

TextWriter.Write(ReadOnlySpan<char>) schrijft tekens uit een geheugenweergave zonder een regeleinde toe te voegen. De aanroeper kan zo een tekstdeel doorgeven zonder een substring te maken, maar dit garandeert niet dat een specifieke writer zonder allocaties schrijft.

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

Syntax

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

TextWriter.Write(ReadOnlySpan<char>) is een synchrone, virtuele overload in de naamruimte System.IO. De methode schrijft de tekens in buffer naar de doeltekststream en retourneert void. In tegenstelling tot WriteLine voegt ze geen regeleinde toe; het is ook geen overload die een opmaakstring en argumenten accepteert.

ReadOnlySpan<char> is een alleen-lezen weergave van tekens. De aanroep text.AsSpan(1, 5) selecteert vijf tekens vanaf index 1 zonder een aparte substring te maken. Geef deze weergave rechtstreeks door aan Write; eerst ToString() aanroepen is niet nodig. De index en lengte moeten binnen de grenzen van de tekst vallen.

De methode is virtueel: het runtime-type van de writer bepaalt de implementatie, ook als de variabele het type TextWriter heeft. Alleen de span-overload gebruiken garandeert niet dat de writer geen allocaties uitvoert of intern kopieert. Maak onderscheid tussen het vermijden van een substring op de aanroepplek en de kosten van schrijven naar de bestemming.

Deze API is beschikbaar sinds .NET Core 2.1 en in .NET Standard 2.1, en blijft beschikbaar in .NET 10; ze is niet nieuw in .NET 10. Het voorbeeld is bedoeld voor de repositoryconfiguratie met net10.0 en LangVersion=preview. Het gebruikt StringWriter via een TextWriter-referentie: het schrijft het tekstdeel hello, daarna ! en toont ten slotte hello! zonder regeleinde.

Voorbeelden

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

Resultaat

hello!

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen