DisplayFormatAttribute.DataFormatString Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger visningsformatet för fältvärdet.
public:
property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };public string DataFormatString { get; set; }public string? DataFormatString { get; set; }member this.DataFormatString : string with get, setPublic Property DataFormatString As StringEgenskapsvärde
En formateringssträng som anger visningsformatet för datafältets värde. Standardvärdet är en tom sträng (""), som anger att ingen särskild formatering tillämpas på fältvärdet.
Exempel
I följande exempel visas hur du använder DataFormatString egenskapen för att ange visningsformatet för datafält. I det första exemplet anges visningsformatet för ett datafält av valutatyp. Det andra exemplet anger visningsformatet för ett datumtypsdatafält.
// 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
Kommentarer
Använd egenskapen DataFormatString för att ange ett anpassat visningsformat för de värden som visas i DynamicField objektet. Om egenskapen DataFormatString inte har angetts visas fältets värde utan någon särskild formatering. Mer information finns i Formateringstyper.
Note
När egenskapen DynamicField.HtmlEncode är trueär värdet för fältet HTML-kodat till dess strängrepresentation innan formateringssträngen tillämpas. För vissa objekt, till exempel datum, kanske du vill styra hur objektet visas med en formateringssträng. I dessa fall måste du ange DynamicField.HtmlEncode egenskapen till false.
Som standard tillämpas formateringssträngen endast på fältvärdet när den databundna kontroll som innehåller DynamicField objektet är i skrivskyddat läge. Om du vill använda formateringssträngen på fältvärden när de är i redigeringsläge anger du ApplyFormatInEditMode egenskapen till true.
Formateringssträngen kan vara valfri literalsträng och innehåller vanligtvis en platshållare för fältets värde. I formateringssträngen "Item Value: {0}" ersätts till exempel fältets värde med {0} platshållaren när strängen visas i DynamicField objektet. Resten av formateringssträngen visas som literaltext.
Note
Om formateringssträngen inte innehåller någon platshållare inkluderas inte fältets värde från datakällan i den slutliga visningstexten.
