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

Object

Der Wert der Zelldaten nach Übernahme der Formatierung, oder null, wenn die Zelle kein Bestandteil eines DataGridView-Steuerelements ist.

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

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 bestimmt zunächst, ob value gültig ist, indem sie bestimmt, ob eine der folgenden Bedingungen erfüllt ist.

value ist in der DataSource - oder - Items Auflistung vorhanden.
value ist null oder DBNull.Value.
value ist String.Empty , und der ValueType -Eigenschaftswert stellt den String Typ dar.

Wenn value ungültig ist, tritt das DataGridView.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.

Wenn value gültig ist oder ein Handler für das DataError Ereignis vorhanden ist und die DataGridViewDataErrorEventArgs.ThrowException -Eigenschaft nicht auf truefestgelegt wird, tritt das DataGridView.CellFormatting -Ereignis auf.

Ein CellFormatting Ereignishandler kann sowohl als auch valuecellStyleändern. Wenn der Handler die DataGridViewCellFormattingEventArgs.FormattingApplied -Eigenschaft jedoch nicht auf truefestgelegt, 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, gibt diese Methode den formatierten Wert für die DataGridView Anzeige im Steuerelement zurück.

Gilt für: