DataGridViewCheckBoxCell.GetFormattedValue Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft den formatierten Wert der Zelldaten ab.

protected:
 override 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 override 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 override 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);
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overrides 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

Object

Der Wert der Zelldaten nach Übernahme der Formatierung, oder null, wenn die Zelle kein Bestandteil eines DataGridView-Steuerelements ist.

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 versucht zunächst, mithilfe der TrueValueEigenschaften , FalseValueund IndeterminateValue in einen Boolean oder CheckState -Wert zu konvertierenvalue, wenn sie festgelegt wurden.

Wenn die Konvertierung nicht erfolgreich ist, tritt das DataGridView.DataError Ereignis auf. Wenn kein Handler für dieses Ereignis vorhanden ist oder der Handler die DataGridViewDataErrorEventArgs.ThrowException Eigenschaft auf truefestlegt, wird eine Ausnahme ausgelöst.

Wenn die Konvertierung erfolgreich ist oder ein Handler für das DataError Ereignis vorhanden ist und die DataGridViewDataErrorEventArgs.ThrowException Eigenschaft nicht auf truefestgelegt wird, tritt das DataGridView.CellFormatting Ereignis auf.

Ein CellFormatting Ereignishandler kann sowohl als auch valuecellStyleändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf truefestgelegt, wird diese Methode mithilfe der Formatierungseigenschaften des cellStyle -Objekts formatiertvalue. Dies kann zu einem zusätzlichen DataError Ereignis führen.

Wenn die Formatierung erfolgreich ist und der context Parameterwert den ClipboardContent Wert enthält, gibt diese Methode die String Version des formatierten Werts zum Kopieren in die Zwischenablage zurück. Andernfalls gibt diese Methode den formatierten Wert für die DataGridView Anzeige im Steuerelement zurück.

Gilt für:

Weitere Informationen