ISpanFormattable.TryFormat Método

Definição

Tenta formatar o valor da instância atual no intervalo de caracteres fornecido.

public:
 bool TryFormat(Span<char> destination, [Runtime::InteropServices::Out] int % charsWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<char> destination, out int charsWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<char> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (destination As Span(Of Char), ByRef charsWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean

Parâmetros

destination
Span<Char>

O intervalo no qual escrever o valor dessa instância formatado como um intervalo de caracteres.

charsWritten
Int32

Quando esse método retorna, contém o número de caracteres que foram gravados em destination.

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 destination.

provider
IFormatProvider

Um objeto opcional que fornece informações de formatação específicas da cultura para destination.

Retornos

Boolean

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 do ToString(String, IFormatProvider) mesmo tipo.
  • TryFormat deve retornar false somente se não houver espaço suficiente no buffer de destino. Quaisquer outras falhas devem gerar uma exceção.

Aplica-se a