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 ab oder legt das Anzeigeformat für den Feldwert 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 spezielle Formatierung auf den Feldwert angewendet wird.
Beispiele
In den DataFormatString folgenden Beispielen wird gezeigt, wie Die Eigenschaft zum Festlegen des Anzeigeformats von Datenfeldern verwendet wird. Im ersten Beispiel wird das Anzeigeformat für ein Währungstyp-Datenfeld festgelegt. Im zweiten Beispiel wird das Anzeigeformat für ein Datumstyp-Datenfeld 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 lautet true, wird der Wert des Felds mit der Zeichenfolgendarstellung codiert, bevor die Formatierungszeichenfolge angewendet wird. Bei einigen Objekten, z. B. Datumsangaben, können Sie steuern, wie das Objekt mit einer Formatierungszeichenfolge angezeigt wird. In diesen Fällen müssen Sie die DynamicField.HtmlEncode Eigenschaft auf false.
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. Wenn Sie die Formatierungszeichenfolge auf Feldwerte anwenden möchten, wenn sie sich im Bearbeitungsmodus befinden, legen Sie die ApplyFormatInEditMode Eigenschaft auf true.
Die Formatierungszeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispiel: In der Formatierungszeichenfolge "Item Value: {0}", the field's value is substituted for the {0} placeholder when the string is displayed in the DynamicField object. Der Rest der Formatierungszeichenfolge wird als Literaltext angezeigt.
Hinweis
Wenn die Formatierungszeichenfolge keinen Platzhalter enthält, wird der Wert des Felds aus der Datenquelle nicht im endgültigen Anzeigetext enthalten.
