DisplayFormatAttribute.DataFormatString Eigenschaft

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Quelle:

DisplayFormatAttribute.cs

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; }

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 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.

Weitere Informationen

• Formatieren von Typen in .NET