CKTIS / C#
TextWriter.Write(ReadOnlySpan<char>) — scrivere una porzione di testo
TextWriter.Write(ReadOnlySpan<char>) scrive caratteri da una vista della memoria senza aggiungere un terminatore di riga. Consente al chiamante di passare una porzione di testo senza creare una sottostringa, ma non garantisce che uno specifico writer operi senza allocazioni.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public virtual void Write(ReadOnlySpan<char> buffer);TextWriter.Write(ReadOnlySpan<char>) è un overload virtuale sincrono nello spazio dei nomi System.IO. Scrive i caratteri di buffer nel flusso di testo di destinazione e restituisce void. A differenza di WriteLine, non aggiunge un terminatore di riga; inoltre, non è un overload che accetta una stringa di formato e degli argomenti.
ReadOnlySpan<char> è una vista di sola lettura di caratteri. La chiamata text.AsSpan(1, 5) seleziona cinque caratteri a partire dall’indice 1 senza creare una sottostringa separata. Passa questa vista direttamente a Write; non è necessario chiamare prima ToString(). L’indice e la lunghezza devono rientrare nei limiti del testo.
Il metodo è virtuale: l’implementazione è determinata dal tipo effettivo del writer, anche quando la variabile è tipizzata come TextWriter. L’uso dell’overload con span, da solo, non garantisce che il writer eviti allocazioni o copie interne. Distingui l’assenza di una sottostringa nel punto di chiamata dal costo della scrittura nella destinazione.
Questa API è disponibile da .NET Core 2.1 e in .NET Standard 2.1, ed è ancora disponibile in .NET 10; non è una novità di .NET 10. L’esempio è destinato alla configurazione del repository net10.0 e LangVersion=preview. Usa StringWriter tramite un riferimento TextWriter: scrive la porzione hello, poi ! e infine stampa hello! senza un terminatore di riga.
Esempi
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());Risultato
hello!
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.