DisplayFormatAttribute.DataFormatString Eigenschaft

  • Referenz

Definition

Namespace:
System.ComponentModel.DataAnnotations
Assembly:
System.ComponentModel.Annotations.dll
Assemblys:
System.ComponentModel.Annotations.dll, System.ComponentModel.DataAnnotations.dll
Assembly:
System.ComponentModel.DataAnnotations.dll

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, set
Public Property DataFormatString As String

Eigenschaftswert

String

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 die DataFormatString Eigenschaft zum Festlegen des Anzeigeformats von Datenfeldern verwendet wird. 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 im DynamicField 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, 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 auf den Feldwert angewendet, wenn das datengebundene Steuerelement, das das DynamicField Objekt enthält, im schreibgeschützten Modus ist. 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 "Elementwert: {0}" wird der Wert des Felds für 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.

Gilt für:

Siehe auch