DisplayFormatAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayFormatAttribute.cs

Specifica il modo in cui i campi dati vengono visualizzati e formattati da ASP.NET Dynamic Data.

public ref class DisplayFormatAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class DisplayFormatAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type DisplayFormatAttribute = class
    inherit Attribute

Public Class DisplayFormatAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

DisplayFormatAttribute

Attributi

AttributeUsageAttribute

Esempio

Vedere un esempio online di questa funzionalità: Esegui.

Nell'esempio seguente viene illustrato come usare per personalizzare la DisplayFormatAttribute formattazione per un campo dati. L'esempio esegue i passaggi seguenti:

• Implementa una classe parziale di metadati e una classe di metadati associata.

• Nella classe di metadati associata viene applicato l'attributo DisplayFormatAttribute per specificare i risultati seguenti:

  • Visualizzare il testo "[Null]" quando un campo dati è vuoto.

  • Visualizzare i dati di valuta in un formato di valuta specifico per le impostazioni locali.

  • Visualizzare le informazioni sulla data in formato breve (mm/gg/aaa). Questo formato si applica anche in modalità di modifica.

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

Per compilare l'esempio, è necessario quanto segue:

• Qualsiasi edizione di Visual Studio 2010 o versione successiva.

• Database di esempio AdventureWorksLT. Per informazioni su come scaricare e installare il database di esempio SQL Server, vedere Microsoft SQL Server Product Samples: Database on GitHub (Esempi di prodotti microsoft SQL Server: database in GitHub). Assicurarsi di installare la versione corretta del database di esempio per la versione di SQL Server in esecuzione.

• Sito Web basato sui dati. In questo modo è possibile creare un contesto dati per il database e la classe che contiene il campo dati da personalizzare. Per altre informazioni, vedere Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Commenti

Quando si applica questo attributo a un campo dati, è necessario seguire le linee guida per l'uso degli attributi. Per altre informazioni, vedere ASP.NET Linee guida per i dati dinamici.

Costruttori

DisplayFormatAttribute()

Inizializza una nuova istanza della classe DisplayFormatAttribute.

Proprietà

ApplyFormatInEditMode	Ottiene o imposta un valore che indica se la stringa di formattazione specificata dalla proprietà DataFormatString viene applicata al valore del campo quando il campo dati è in modalità di modifica.
ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se i valori di stringa vuota ("") vengono automaticamente convertiti in null quando il campo dati viene aggiornato nell'origine dati.
DataFormatString	Ottiene o imposta il formato di visualizzazione per il valore del campo.
HtmlEncode	Ottiene o imposta un valore che indica se il campo deve essere codificato in formato HTML.
NullDisplayText	Ottiene o imposta il testo visualizzato per un campo quando il valore del campo è null.
NullDisplayTextResourceType	Ottiene o imposta Type che contiene le risorse per NullDisplayText. L'uso di NullDisplayTextResourceType insieme a NullDisplayText consente al metodo GetNullDisplayText() di restituire i valori localizzati.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetNullDisplayText()	Restituisce la stringa di visualizzazione dell'interfaccia utente per NullDisplayText.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Procedura: impostare le impostazioni cultura e le impostazioni cultura dell'interfaccia utente per la globalizzazione della pagina Web ASP.NET