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

Definition

Ruft den zum Anzeigen formatierten Wert der Zelle ab.Gets the value of the cell as formatted for display.

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);
abstract member GetFormattedValue : obj * int *  * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int *  * 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 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 formatierte Wert der Zelle oder null, wenn die Zelle keinem DataGridView-Steuerelement angehört.The formatted value of the cell or null if the cell does not belong to 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 in der Regel in den Typ FormatException umgewandelt werden.The exception object can typically be cast to type FormatException.

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 löst das DataGridView.CellFormatting -Ereignis aus.This method raises the DataGridView.CellFormatting event. Ein Handler für dieses Ereignis kann sowohl den- value Parameter cellStyle als auch den-Parameter ändern.A handler for this event can modify both the value and cellStyle parameters. 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.

Hinweis

Diese Methode value konvertiert nicht in den DataGridViewCellStyle.NullValue -Eigenschafts Wert für-Werte, DataGridViewCellStyle.DataSourceNullValue die dem- DataSourceNullValue Eigenschafts Wert entsprechen, wenn auf DBNull.Value einen nullanderen Wert als oder festgelegt wird.This method does not convert value to the DataGridViewCellStyle.NullValue property value for values equal to the DataGridViewCellStyle.DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. In diesem Fall können Sie das DataGridView.CellFormatting -Ereignis behandeln, um den NullValue Eigenschafts Wert anzuzeigen.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Weitere Informationen finden Sie im Codebeispiel unter DataSourceNullValue.For more information, see the code example in DataSourceNullValue.

Wenn die Formatierung nicht erfolgreich ist DataError , tritt das-Ereignis auf.If formatting is unsuccessful, the 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.

Abgeleitete Klassen, die diese Methode überschreiben, geben in der Regel eine Zeichen folgen Darstellung context des Zellwerts ClipboardContent zurück, wenn das Argument den Wert enthält.Derived classes that override this method will typically return a string representation of the cell value if the context argument includes the ClipboardContent value.

Gilt für:

Siehe auch