ISpanFormattable.TryFormat Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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.