IUtf8SpanFormattable.TryFormat Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Tenta formatar o valor da instância atual como UTF-8 no intervalo fornecido de bytes.
public:
bool TryFormat(Span<System::Byte> utf8Destination, [Runtime::InteropServices::Out] int % bytesWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<byte> utf8Destination, out int bytesWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<byte> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (utf8Destination As Span(Of Byte), ByRef bytesWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean
Parâmetros
O intervalo no qual gravar o valor dessa instância formatado como um intervalo de bytes.
- bytesWritten
- Int32
Quando esse método retorna, contém o número de bytes que foram gravados em utf8Destination
.
- format
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam uma cadeia de caracteres de formatação padrão ou personalizada que define o formato aceitável de utf8Destination
.
- provider
- IFormatProvider
Um objeto opcional que fornece informações de formatação específicas da cultura para utf8Destination
.
Retornos
true
se a formatação for bem-sucedida. Caso contrário, false
.
Comentários
Uma implementação dessa interface deve produzir a mesma cadeia de caracteres que uma implementação de ToString(String, IFormatProvider) ou TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) no mesmo tipo. TryFormat só deverá retornar false
se não houver espaço suficiente no buffer de destino; quaisquer outras falhas devem gerar uma exceção.