DisplayFormatAttribute.DataFormatString Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou definem o formato de exibição para o valor do campo.
public:
property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };public string DataFormatString { get; set; }member this.DataFormatString : string with get, setPublic Property DataFormatString As StringValor de Propriedade
Uma cadeia de formatação que especifica o formato de exibição para o valor do campo de dados. O padrão é uma cadeia vazia (""), o que indica que não é aplicada qualquer formatação especial ao valor do campo.
Exemplos
Os exemplos seguintes mostram como usar a DataFormatString propriedade para definir o formato de exibição dos campos de dados. O primeiro exemplo define o formato de exibição para um campo de dados de tipo moeda. O segundo exemplo define o formato de exibição para um campo de dados de tipo data.
// Display currency data field in the format $1,345.50.
[DisplayFormat(DataFormatString="{0:C}")]
public object StandardCost;
' Display currency data field in the format such as $1,345.50.
<DisplayFormat(DataFormatString:="{0:C}")> _
Public StandardCost As Object
// Display date data field in the short format 11/12/08.
// Also, apply format in edit mode.
[DisplayFormat(ApplyFormatInEditMode=true, DataFormatString = "{0:d}")]
public object SellStartDate;
' Display date data field in the short format such as 11/12/08.
' Also, apply format in edit mode.
<DisplayFormat(ApplyFormatInEditMode:=True, DataFormatString:="{0:d}")> _
Public SellStartDate As Object
Observações
Use a DataFormatString propriedade para especificar um formato de exibição personalizado para os valores que são apresentados no DynamicField objeto. Se a DataFormatString propriedade não estiver definida, o valor do campo é exibido sem qualquer formatação especial. Para obter mais informações, consulte Tipos de formatação.
Observação
Quando a DynamicField.HtmlEncode propriedade é true, o valor do campo é codificado em HTML para a sua representação de cadeia antes de aplicar a cadeia de formatação. Para alguns objetos, como datas, pode querer controlar como o objeto é apresentado com uma cadeia de formatação. Nesses casos, deve definir a DynamicField.HtmlEncode propriedade para false.
Por defeito, a cadeia de formatação é aplicada ao valor do campo apenas quando o controlo limitado por dados que contém o DynamicField objeto está em modo apenas de leitura. Para aplicar a cadeia de formatação aos valores dos campos quando estiverem em modo de edição, defina a ApplyFormatInEditMode propriedade para true.
A cadeia de formatação pode ser qualquer cadeia literal e normalmente inclui um marcador para o valor do campo. Por exemplo, na cadeia de formatação "Item Value: {0}", o valor do campo é substituído pelo {0} marcador quando a cadeia é exibida no DynamicField objeto. O restante da cadeia de formatação é apresentado como texto literal.
Observação
Se a cadeia de formatação não incluir um marcador de posição, o valor do campo da fonte de dados não é incluído no texto final de visualização.