Interfaccia IFormatProvider

IFormatProvider l'interfaccia offre un oggetto che fornisce informazioni di formattazione per formattare e le operazioni di analisi. Le operazioni di formattazione di convertire il valore di un tipo nella rappresentazione di stringa del valore. I metodi di formattazione tipici comprendono ToString metodi di tipo nonché Format. Le operazioni di analisi consentono di convertire la rappresentazione di stringa di un valore a un tipo con tale valore. I tipici metodi di analisi sono Parse e TryParse.

IFormatProvider l'interfaccia è composta da un singolo metodo, IFormatProvider.GetFormat. GetFormat è un metodo di callback: L'analisi o il metodo di formattazione viene chiamato e le passa un' Type oggetto che rappresenta il tipo di oggetto che la formattazione o il metodo LAAAM richiede fornirà informazioni di formattazione. GetFormat il metodo è responsabile della restituzione di un oggetto di tale tipo.

IFormatProvider le implementazioni vengono spesso utilizzate in modo implicito formattazione e l'analisi dei metodi. Ad esempio, DateTime.ToString(String) il metodo utilizza in modo implicito IFormatProvider implementazione di che rappresenta le impostazioni cultura correnti del sistema. IFormatProvider le implementazioni possano essere specificato in modo esplicito con metodi che dispongono di un parametro di tipo IFormatProvider, ad esempio Int32.Parse(String, IFormatProvider) e String.Format(IFormatProvider, String, Object[]).

In.NET Framework sono disponibili i seguenti tre predefiniti IFormatProvider implementazioni per fornire informazioni specifiche delle impostazioni cultura utilizzate nella formattazione o tracciatura numerica e valori di data e ora:

• NumberFormatInfo la classe, che fornisce le informazioni utilizzate per formattare i numeri, ad esempio la valuta, separatore delle migliaia e simboli del separatore decimale per impostazioni cultura specifiche.

• DateTimeFormatInfo la classe, che fornisce le informazioni utilizzate per formattare le date e ore, ad esempio i simboli dei separatori di data e ora per impostazioni cultura specifiche o l'ordine e form dell'anno, del mese e dei componenti relativi ai giorni di una data.

• CultureInfo classe, che rappresenta determinate impostazioni cultura. Relativo GetFormat il metodo restituisce uno specifico delle impostazioni cultura NumberFormatInfo o DateTimeFormatInfo oggetto, a seconda che CultureInfo l'oggetto viene utilizzato in una formattazione o in un'operazione di analisi che include i numeri o date e ore.

.NET Framework supporta inoltre la formattazione personalizzata. In genere ciò include la creazione di una classe di formattazione che implementa entrambe IFormatProvider e ICustomFormatter. Un'istanza di questa classe viene quindi passata come parametro a un metodo che esegue un'operazione di formattazione personalizzata, ad esempio String.Format(IFormatProvider, String, Object[]) L'esempio si riferisce di tale implementazione personalizzata che formatta un numero come numero di conto di 12 cifre.

Nell'esempio seguente viene illustrato come IFormatProvider l'implementazione possibile modificare la rappresentazione di un valore di data e ora. In questo caso, una singola data viene visualizzata utilizzando CultureInfo oggetti che rappresentano quattro impostazioni cultura diverse.

Nell'esempio seguente viene illustrato l'utilizzo di una classe che implementa IFormatProvider interfaccia e GetFormat metodo. AcctNumberFormat la classe converte Int64 valore che rappresenta un numero di conto a un numero di account formattato di 12 cifre. Relativo GetFormat il metodo restituisce un riferimento alla corrente AcctNumberFormat istanza di se formatType il parametro fa riferimento alla classe che implementa ICustomFormatter; in caso contrario, GetFormat restituisce riferimento null (Nothing in Visual Basic).

la classe che implementa IFormatProvider può quindi essere utilizzato in una chiamata a una formattazione e in un'operazione di analisi. Ad esempio, il codice seguente chiama String.Format(IFormatProvider, String, Object[]) metodo per generare una stringa contenente un numero di account formattato di 12 cifre.

.NET Framework

.NET Framework Client Profile

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti

Altre risorse