DataGridViewCell.GetFormattedValue Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 zum Anzeigen formatierten Wert der Zelle ab.

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

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

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 formatierte Wert der Zelle oder null, wenn die Zelle keinem DataGridView-Steuerelement angehört.

Ausnahmen

Exception

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. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.

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 löst das DataGridView.CellFormatting Ereignis aus. Ein Handler für dieses Ereignis kann sowohl die valuecellStyle Parameter als auch ändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf truefestgelegt, wird diese Methode mithilfe der Formatierungseigenschaften des cellStyle -Objekts formatiertvalue.

Hinweis

Diese Methode konvertiert nicht in value den DataGridViewCellStyle.NullValue Eigenschaftswert für Werte, die dem DataGridViewCellStyle.DataSourceNullValue Eigenschaftswert entsprechen, wenn DataSourceNullValue auf einen anderen Wert als DBNull.Value oder nullfestgelegt ist. In diesem Fall können Sie das DataGridView.CellFormatting Ereignis behandeln, um den NullValue Eigenschaftswert anzuzeigen. Weitere Informationen finden Sie im Codebeispiel unter DataSourceNullValue.

Wenn die Formatierung nicht erfolgreich ist, tritt das 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.

Abgeleitete Klassen, die diese Methode überschreiben, geben in der Regel eine Zeichenfolgendarstellung des Zellwerts zurück, wenn das context Argument den ClipboardContent Wert enthält.

Gilt für: