Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

TextWriter.Write(ReadOnlySpan<char>) — escrever um segmento de texto

TextWriter.Write(ReadOnlySpan<char>) escreve caracteres de uma vista da memória sem acrescentar um terminador de linha. Permite que quem chama passe um segmento de texto sem criar uma substring, mas não garante uma escrita sem alocações num writer específico.

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

Sintaxe

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

TextWriter.Write(ReadOnlySpan<char>) é uma sobrecarga virtual síncrona do espaço de nomes System.IO. Escreve os caracteres de buffer no fluxo de texto de destino e devolve void. Ao contrário de WriteLine, não acrescenta um terminador de linha; também não é uma sobrecarga que aceite uma cadeia de formato e argumentos.

ReadOnlySpan<char> é uma vista só de leitura de caracteres. A chamada text.AsSpan(1, 5) seleciona cinco caracteres a partir do índice 1, sem criar uma substring separada. Passa esta vista diretamente a Write; não é necessário chamar ToString() primeiro. O índice e o comprimento têm de estar dentro dos limites do texto.

O método é virtual: o tipo real do writer determina a implementação, mesmo quando a variável está tipada como TextWriter. Usar a sobrecarga com span, por si só, não garante que o writer não faça alocações nem cópias internas. Distingue entre evitar uma substring no ponto da chamada e o custo de escrever no destino.

Esta API está disponível desde o .NET Core 2.1 e no .NET Standard 2.1, e continua disponível no .NET 10; não é uma novidade do .NET 10. O exemplo destina-se à configuração do repositório net10.0 e LangVersion=preview. Usa StringWriter através de uma referência TextWriter: escreve o segmento hello, depois ! e, por fim, apresenta hello! sem terminador de linha.

Exemplos

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

Resultado

hello!

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes