DisplayFormatAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 AttributePublic Class DisplayFormatAttribute
Inherits Attribute- Ereditarietà
- Attributi
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 |
| 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 è |
| 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) |
Implementazioni dell'interfaccia esplicita
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute) |
