DataGridViewComboBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) Methode

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

Der zu formatierende Wert.The value to be formatted.

rowIndex
Int32

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

cellStyle
DataGridViewCellStyle

Der für die Zelle gültige DataGridViewCellStyle.The DataGridViewCellStyle in effect for the cell.

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.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

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

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.

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.Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. Das Ausnahmeobjekt kann bei Typkonvertierungsfehlern i. d. R. in den FormatException-Typ umgewandelt werden, oder es wird in den ArgumentException-Typ umgewandelt, wenn value nicht in DataSource oder in der Items-Auflistung enthalten ist.The exception object can typically be cast to type FormatException for type conversion errors or to type ArgumentException if value cannot be found in the DataSource or the Items collection.

Hinweise

Das DataGridView-Steuerelement ruft diese Methode auf, um einen Zellwert in einen entsprechenden Anzeige Wert des Typs zu konvertieren, der durch die FormattedValueType-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 im value-Parameter.The control passes the cell value to this method in the value parameter.

Diese Methode bestimmt zunächst, ob value gültig ist, indem ermittelt wird, ob eine der folgenden Bedingungen erfüllt ist.This method first determines whether value is valid by determining whether one of the following conditions is met.

Wenn value nicht gültig ist, tritt das DataGridView.DataError-Ereignis auf.If value is not valid, 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 value gültig ist oder ein Handler für das DataError-Ereignis vorhanden ist und die DataGridViewDataErrorEventArgs.ThrowException-Eigenschaft nicht auf truefestgelegt ist, tritt das DataGridView.CellFormatting-Ereignis auf.If value is valid 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 auch cellStyleändern.A CellFormatting event handler can modify both value and cellStyle. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied-Eigenschaft nicht auf truefestgelegt hat, formatiert diese Methode jedoch value mithilfe der Formatierungs Eigenschaften des cellStyle 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, gibt diese Methode den formatierten Wert für die Anzeige im DataGridView Steuerelement zurück.If formatting is successful, this method returns the formatted value for display in the DataGridView control.

Gilt für:

Siehe auch