DataGridViewCheckBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCheckBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCheckBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCheckBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) Method

Definition

Ruft den formatierten Wert der Zelldaten ab.Gets the formatted value of the cell's data.

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);
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 Object Object Object

Der zu formatierende Wert.The value to be formatted.

rowIndex
Int32 Int32 Int32 Int32

Der Index der übergeordneten Zeile der Zelle.The index of the cell's parent row.

valueTypeConverter
TypeConverter TypeConverter TypeConverter 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.A TypeConverter associated with the value type that provides custom conversion to the formatted value type, or null if no such custom conversion is needed.

formattedValueTypeConverter
TypeConverter TypeConverter TypeConverter 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.A TypeConverter associated with the formatted value type that provides custom conversion from the value type, or null if no such custom conversion is needed.

context
DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts

Eine bitweise Kombination von DataGridViewDataErrorContexts-Werten, die den Kontext beschreibt, in dem der formatierte Wert benötigt wird.A bitwise combination of DataGridViewDataErrorContexts values describing the context in which the formatted value is needed.

Gibt zurück

Der Wert der Zelldaten nach Übernahme der Formatierung, oder null, wenn die Zelle kein Bestandteil eines DataGridView-Steuerelements ist.The value of the cell's data after formatting has been applied or null if the cell is not part of a DataGridView control.

Hinweise

Das DataGridView -Steuerelement ruft diese Methode auf, um einen Zellwert in einen entsprechenden Anzeige Wert des Typs zu FormattedValueType konvertieren, der durch die-Eigenschaft angegeben wird.The DataGridView control calls this method to convert a cell value into an equivalent display value of the type indicated by the FormattedValueType property. Das-Steuerelement übergibt den Zellwert an diese Methode value im-Parameter.The control passes the cell value to this method in the value parameter.

Diese Methode versucht zunächst, mithilfe value der TrueValueEigenschaften Boolean , CheckState FalseValueund in einen-Wert oder IndeterminateValue einen-Wert zu konvertieren, wenn Sie festgelegt wurden.This method first attempts to convert value to a Boolean or CheckState value using the TrueValue, FalseValue, and IndeterminateValue properties if they have been set.

Wenn die Konvertierung nicht erfolgreich ist, DataGridView.DataError tritt das-Ereignis auf.If the conversion is unsuccessful, the DataGridView.DataError event occurs. Wenn kein Handler für dieses Ereignis vorhanden ist oder der Handler die DataGridViewDataErrorEventArgs.ThrowException -Eigenschaft auf truefestlegt, wird eine-Ausnahme ausgelöst.If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs.ThrowException property to true, an exception is thrown.

Wenn die Konvertierung erfolgreich ist oder DataError ein Handler für das-Ereignis vorhanden ist und die DataGridViewDataErrorEventArgs.ThrowException -Eigenschaft nicht auf festgelegt ist DataGridView.CellFormatting , tritt das-Ereignis auf true.If the conversion is successful or there is a handler for the DataError event and it does not set the DataGridViewDataErrorEventArgs.ThrowException property to true, the DataGridView.CellFormatting event occurs.

Ein CellFormatting -Ereignishandler kann sowohl value als cellStyleauch ändern.A CellFormatting event handler can modify both value and cellStyle. Wenn der DataGridViewCellFormattingEventArgs.FormattingApplied Handler die-Eigenschaft value jedoch nicht auf truefestgelegt, formatiert diese Methode mithilfe der Formatierungs Eigenschaften cellStyle des-Objekts.If the handler does not set the DataGridViewCellFormattingEventArgs.FormattingApplied property to true, however, this method formats value using the formatting properties of the cellStyle object. Dies kann zu einem zusätzlichen DataError Ereignis führen.This can result in an additional DataError event.

Wenn die Formatierung erfolgreich ist und context der Wert des- ClipboardContent Parameters den Wert enthält, String gibt diese Methode die Version des formatierten Werts zum Kopieren in die Zwischenablage zurück.If formatting is successful and the context parameter value includes the ClipboardContent value, this method returns the String version of the formatted value for copying to the Clipboard. Andernfalls gibt diese Methode den formatierten Wert für die DataGridView Anzeige im-Steuerelement zurück.Otherwise, this method returns the formatted value for display in the DataGridView control.

Gilt für:

Siehe auch