DisplayFormatAttribute.DataFormatString Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Anzeigeformat für den Feldwert ab oder legt ihn fest.
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 StringEigenschaftswert
Eine Formatierungszeichenfolge, die das Anzeigeformat für den Wert des Datenfelds angibt. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass keine besondere Formatierung auf den Feldwert angewendet wird.
Beispiele
In den folgenden Beispielen wird gezeigt, wie sie die DataFormatString -Eigenschaft verwenden, um das Anzeigeformat von Datenfeldern festzulegen. Im ersten Beispiel wird das Anzeigeformat für ein Währungstypdatenfeld festgelegt. Im zweiten Beispiel wird das Anzeigeformat für ein Datumstypdatenfeld festgelegt.
// 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
Hinweise
Verwenden Sie die DataFormatString -Eigenschaft, um ein benutzerdefiniertes Anzeigeformat für die werte anzugeben, die DynamicField im -Objekt angezeigt werden. Wenn die DataFormatString Eigenschaft nicht festgelegt ist, wird der Wert des Felds ohne spezielle Formatierung angezeigt. Weitere Informationen finden Sie unter Formatieren von Typen in .NET.
Hinweis
Wenn die DynamicField.HtmlEncode -Eigenschaft ist true, wird der Wert des Felds in seiner Zeichenfolgendarstellung html-codiert, bevor die Formatierungszeichenfolge angewendet wird. Bei einigen Objekten, z. B. Datumsangaben, möchten Sie möglicherweise steuern, wie das Objekt mit einer Formatierungszeichenfolge angezeigt wird. In diesen Fällen müssen Sie die DynamicField.HtmlEncode -Eigenschaft auf falsefestlegen.
Standardmäßig wird die Formatierungszeichenfolge nur dann auf den Feldwert angewendet, wenn sich das datengebundene Steuerelement, das das DynamicField Objekt enthält, im schreibgeschützten Modus befindet. Um die Formatierungszeichenfolge auf Feldwerte anzuwenden, wenn sie sich im Bearbeitungsmodus befinden, legen Sie die ApplyFormatInEditMode -Eigenschaft auf fest true.
Die Formatierungszeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispielsweise wird in der Formatierungszeichenfolge "Item Value: " {0}der Wert des Felds durch den {0} Platzhalter ersetzt, wenn die Zeichenfolge im DynamicField -Objekt angezeigt wird. Der Rest der Formatierungszeichenfolge wird als Literaltext angezeigt.
Hinweis
Wenn die Formatierungszeichenfolge keinen Platzhalter enthält, ist der Wert des Felds aus der Datenquelle nicht im endgültigen Anzeigetext enthalten.
