DataGridViewCell.GetFormattedValue Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den zum Anzeigen formatierten Wert der Zelle ab.
protected:
virtual System::Object ^ GetFormattedValue(System::Object ^ value, int rowIndex, System::Windows::Forms::DataGridViewCellStyle ^ % cellStyle, System::ComponentModel::TypeConverter ^ valueTypeConverter, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::Windows::Forms::DataGridViewDataErrorContexts context);
protected virtual object GetFormattedValue (object value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter valueTypeConverter, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);
protected virtual object? GetFormattedValue (object? value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter? valueTypeConverter, System.ComponentModel.TypeConverter? formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);
abstract member GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overridable Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As Object
Parameter
- value
- Object
Der zu formatierende Wert.
- rowIndex
- Int32
Der Index der übergeordneten Zeile der Zelle.
- cellStyle
- DataGridViewCellStyle
Der für die Zelle gültige DataGridViewCellStyle.
- valueTypeConverter
- TypeConverter
Ein dem Werttyp zugeordneter TypeConverter, der eine benutzerdefinierte Konvertierung in den formatierten Werttyp ermöglicht, oder null
, wenn solch eine benutzerdefinierte Konvertierung nicht erforderlich ist.
- formattedValueTypeConverter
- TypeConverter
Ein dem formatierten Werttyp zugeordneter TypeConverter, der eine benutzerdefinierte Konvertierung aus dem Werttyp ermöglicht, oder null
, wenn solch eine benutzerdefinierte Konvertierung nicht erforderlich ist.
- context
- DataGridViewDataErrorContexts
Eine bitweise Kombination von DataGridViewDataErrorContexts-Werten, die den Kontext beschreibt, in dem der formatierte Wert benötigt wird.
Gibt zurück
Der formatierte Wert der Zelle oder null
, wenn die Zelle keinem DataGridView-Steuerelement angehört.
Ausnahmen
Bei der Formatierung sind Fehler aufgetreten. Entweder ist kein Handler für das DataError-Ereignis des DataGridView-Steuerelements vorhanden, oder der Handler hat die ThrowException-Eigenschaft auf true
festgelegt. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.
Hinweise
Das DataGridView -Steuerelement ruft diese Methode auf, um einen Zellenwert in einen entsprechenden Anzeigewert des typs zu konvertieren, der von der FormattedValueType -Eigenschaft angegeben ist. Das Steuerelement übergibt den Zellwert an diese Methode im value
Parameter.
Diese Methode löst das DataGridView.CellFormatting Ereignis aus. Ein Handler für dieses Ereignis kann sowohl die value
cellStyle
Parameter als auch ändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf true
festgelegt, wird diese Methode mithilfe der Formatierungseigenschaften des cellStyle
-Objekts formatiertvalue
.
Hinweis
Diese Methode konvertiert nicht in value
den DataGridViewCellStyle.NullValue Eigenschaftswert für Werte, die dem DataGridViewCellStyle.DataSourceNullValue Eigenschaftswert entsprechen, wenn DataSourceNullValue auf einen anderen Wert als DBNull.Value oder null
festgelegt ist. In diesem Fall können Sie das DataGridView.CellFormatting Ereignis behandeln, um den NullValue Eigenschaftswert anzuzeigen. Weitere Informationen finden Sie im Codebeispiel unter DataSourceNullValue.
Wenn die Formatierung nicht erfolgreich ist, tritt das DataError Ereignis auf. Wenn kein Handler für dieses Ereignis vorhanden ist oder der Handler die DataGridViewDataErrorEventArgs.ThrowException Eigenschaft auf true
festlegt, wird eine Ausnahme ausgelöst.
Abgeleitete Klassen, die diese Methode überschreiben, geben in der Regel eine Zeichenfolgendarstellung des Zellwerts zurück, wenn das context
Argument den ClipboardContent Wert enthält.