DisplayFormatAttribute Klasse

Definition

Gibt an, wie Datenfelder von ASP.NET Dynamic Data angezeigt und formatiert werden.Specifies how data fields are displayed and formatted by ASP.NET Dynamic Data.

public ref class DisplayFormatAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
[System.AttributeUsage]
public class DisplayFormatAttribute : Attribute
type DisplayFormatAttribute = class
    inherit Attribute
Public Class DisplayFormatAttribute
Inherits Attribute
Vererbung
DisplayFormatAttribute
Attribute

Beispiele

Ein Online Beispiel für diese Funktion finden Sie hier: FührenSie aus.See an online example of this feature: Run.

Im folgenden Beispiel wird gezeigt, wie die DisplayFormatAttribute verwendet wird, um die Formatierung für ein Datenfeld anzupassen.The following example shows how to use the DisplayFormatAttribute to customize formatting for a data field. Das Beispiel führt die folgenden Schritte aus:The example performs the following steps:

  • Implementiert eine partielle Metadatenklasse und eine zugeordnete Metadatenklasse.Implements a metadata partial class and an associated metadata class.

  • In der zugehörigen Metadatenklasse wendet Sie das DisplayFormatAttribute-Attribut an, um die folgenden Ergebnisse anzugeben:In the associated metadata class, it applies the DisplayFormatAttribute attribute to specify the following results:

    • Zeigen Sie den Text "[null]" an, wenn ein Datenfeld leer ist.Display the text "[Null]" when a data field is empty.

    • Zeigt Währungs Daten im Gebiets Schema spezifischen Währungs Format an.Display currency data in locale specific currency format.

    • Datumsinformationen in Kurzform anzeigen (mm/tt/jj).Display date information in short format (mm/dd/yy). Dieses Format gilt auch für den Bearbeitungsmodus.This format also applies in edit mode.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;


[MetadataType(typeof(ProductMetaData))]
public partial class Product
{

}

public class ProductMetaData
{
    
    // Applying DisplayFormatAttribute
    // Display the text [Null] when the data field is empty.
    // Also, convert empty string to null for storing.
    [DisplayFormat(ConvertEmptyStringToNull = true, NullDisplayText = "[Null]")]
    public object Size;

    // Display currency data field in the format $1,345.50.
    [DisplayFormat(DataFormatString="{0:C}")]
    public object StandardCost;

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

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(ProductMetaData))> _
Partial Public Class Product

End Class

Public Class ProductMetaData
   
    ' Applying DisplayFormatAttribute

    ' Display the text [Null] when the data field is empty.
    ' Also, convert empty string to null for storing.
    <DisplayFormat(ConvertEmptyStringToNull:=True, NullDisplayText:="[Null]")> _
    Public Size As Object

    ' 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 such as 11/12/08.
    ' Also, apply format in edit mode.
    <DisplayFormat(ApplyFormatInEditMode:=True, DataFormatString:="{0:d}")> _
    Public SellStartDate As Object

End Class

Um das Beispiel zu kompilieren, benötigen Sie Folgendes:To compile the example, you need the following:

  • Eine beliebige Edition von Visual Studio 2010 oder höher.Any edition of Visual Studio 2010 or later.

  • Die AdventureWorksLT-Beispieldatenbank.The AdventureWorksLT sample database. Informationen zum herunterladen und Installieren der SQL Server-Beispieldatenbank finden Sie unter [Microsoft SQL Server Product Samples: Database @ no__t-0 auf GitHub.For information about how to download and install the SQL Server sample database, see Microsoft SQL Server Product Samples: Database on GitHub. Stellen Sie sicher, dass Sie die richtige Version der-Beispieldatenbank für die Version der SQL Server installieren, die Sie ausführen.Make sure that you install the correct version of the sample database for the version of SQL Server that you are running.

  • Eine datengesteuerte Website.A data-driven Web site. Dies ermöglicht es Ihnen, einen Datenkontext für die Datenbank und die Klasse zu erstellen, die das Datenfeld enthält, das angepasst werden soll.This enables you to create a data context for the database and the class that contains the data field to customize. Weitere Informationen finden Sie unter Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.For more information, see Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Hinweise

Wenn Sie dieses Attribut auf ein Datenfeld anwenden, müssen Sie die Richtlinien für die Verwendung der Attribute befolgen.When you apply this attribute to a data field, you must follow the guidelines for the use of the attributes. Weitere Informationen finden Sie unter ASP.net dynamische Daten Guidelines.For more information, see ASP.NET Dynamic Data Guidelines.

Konstruktoren

DisplayFormatAttribute()

Initialisiert eine neue Instanz der DisplayFormatAttribute-Klasse.Initializes a new instance of the DisplayFormatAttribute class.

Eigenschaften

ApplyFormatInEditMode

Ruft einen Wert ab, der angibt, ob die von der DataFormatString-Eigenschaft angegebene Formatierungszeichenfolge auf den Feldwert angewendet wird, wenn sich das Datenfeld im Bearbeitungsmodus befindet, oder legt diesen fest.Gets or sets a value that indicates whether the formatting string that is specified by the DataFormatString property is applied to the field value when the data field is in edit mode.

ConvertEmptyStringToNull

Ruft einen Wert ab, der angibt, ob bei der Aktualisierung des Datenfelds in der Datenquelle Werte, die leere Zeichenfolgen ("") darstellen, in null konvertiert werden, oder legt diesen fest.Gets or sets a value that indicates whether empty string values ("") are automatically converted to null when the data field is updated in the data source.

DataFormatString

Ruft das Anzeigeformat für den Feldwert ab oder legt ihn fest.Gets or sets the display format for the field value.

HtmlEncode

Ruft einen Wert ab, der angibt, ob das Feld HTML-codiert sein muss, oder legt diesen Wert fest.Gets or sets a value that indicates whether the field should be HTML-encoded.

NullDisplayText

Ruft den Text ab, der für ein Feld angezeigt wird, wenn der Wert des Felds null ist, oder legt diesen fest.Gets or sets the text that is displayed for a field when the field's value is null.

NullDisplayTextResourceType

Ruft den Type ab, der die Ressourcen für NullDisplayText enthält, oder legt diesen fest.Gets or sets the Type that contains the resources for NullDisplayText.

Die Verwendung von NullDisplayTextResourceType zusammen mit NullDisplayText ermöglicht der GetNullDisplayText()-Methode, lokalisierte Werte zurückzugeben.Using NullDisplayTextResourceType along with NullDisplayText, allows the GetNullDisplayText() method to return localized values.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Geerbt von Attribute)

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Geerbt von Attribute)
GetNullDisplayText()

Gibt die Zeichenfolge zur Anzeige in der Benutzeroberfläche für NullDisplayText zurück.Returns the UI display string for NullDisplayText.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Geerbt von Attribute)

Gilt für:

Siehe auch