DataGridViewCheckBoxCell.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 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
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 true
festlegt, 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 true
festgelegt wird, tritt das DataGridView.CellFormatting Ereignis auf.
Ein CellFormatting Ereignishandler kann sowohl als auch value
cellStyle
ändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf true
festgelegt, 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für