CKTIS / C#
TextWriter.Write(ReadOnlySpan<char>) — écrire une portion de texte
TextWriter.Write(ReadOnlySpan<char>) écrit les caractères d’une vue mémoire sans ajouter de terminaison de ligne. L’appelant peut ainsi transmettre une portion de texte sans créer de sous-chaîne, mais cela ne garantit pas l’absence d’allocations dans un writer donné.
Version : .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>) est une surcharge virtuelle synchrone de l’espace de noms System.IO. Elle écrit les caractères de buffer dans le flux de texte de destination et renvoie void. Contrairement à WriteLine, elle n’ajoute pas de terminaison de ligne ; ce n’est pas non plus une surcharge qui accepte une chaîne de format et des arguments.
ReadOnlySpan<char> est une vue en lecture seule sur des caractères. L’appel text.AsSpan(1, 5) sélectionne cinq caractères à partir de l’index 1 sans créer de sous-chaîne distincte. Passez cette vue directement à Write ; appeler ToString() au préalable est inutile. L’index et la longueur doivent rester dans les limites du texte.
La méthode est virtuelle : le type réel du writer détermine l’implémentation, même lorsque la variable est typée comme TextWriter. À elle seule, l’utilisation de la surcharge avec span ne garantit ni l’absence d’allocations ni l’absence de copies internes dans le writer. Distinguez l’évitement d’une sous-chaîne au point d’appel du coût de l’écriture vers la destination.
Cette API est disponible depuis .NET Core 2.1 et dans .NET Standard 2.1, et reste disponible dans .NET 10 ; elle n’est pas nouvelle dans .NET 10. L’exemple cible la configuration du dépôt net10.0 et LangVersion=preview. Il utilise StringWriter via une référence TextWriter : il écrit la portion hello, puis !, et affiche enfin hello! sans terminaison de ligne.
Exemples
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());Résultat
hello!
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.