Share via


DataGridViewComboBoxCell.GetFormattedValue Yöntem

Tanım

Hücre verilerinin biçimlendirilmiş değerini alır.

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

Parametreler

value
Object

Biçimlendirilecek değer.

rowIndex
Int32

Hücrenin üst satırının dizini.

cellStyle
DataGridViewCellStyle

DataGridViewCellStyle Hücre için geçerli olan.

valueTypeConverter
TypeConverter

TypeConverter Biçimlendirilmiş değer türüne özel dönüştürme sağlayan değer türüyle ilişkili veya null böyle bir özel dönüştürme gerekmiyorsa.

formattedValueTypeConverter
TypeConverter

Değer TypeConverter türünden özel dönüştürme sağlayan biçimlendirilmiş değer türüyle ilişkili veya null böyle bir özel dönüştürme gerekmiyorsa.

context
DataGridViewDataErrorContexts

Biçimlendirilmiş değerin DataGridViewDataErrorContexts gerekli olduğu bağlamı açıklayan değerlerin bit düzeyinde birleşimi.

Döndürülenler

Biçimlendirme uygulandıktan sonra hücre verilerinin değeri veya null hücre bir DataGridView denetimin parçası değilse.

Özel durumlar

Biçimlendirme başarısız oldu ve denetimin DataError olayı DataGridView için işleyici yok veya işleyici özelliğini olarak trueayarladıThrowException. Özel durum nesnesi genellikle tür dönüştürme hataları için yazılacak FormatException veya veya Items koleksiyonunda DataSource bulunamıyorsa value yazılabilirArgumentException.

Açıklamalar

Denetim, DataGridView bir hücre değerini özelliği tarafından FormattedValueType belirtilen türdeki eşdeğer bir görüntüleme değerine dönüştürmek için bu yöntemi çağırır. Denetim, hücre değerini parametresindeki bu yönteme value geçirir.

Bu yöntem önce aşağıdaki koşullardan birinin karşılanıp karşılanmadığını belirleyerek geçerli olup olmadığını belirler value .

value Geçerli değilse, DataGridView.DataError olay gerçekleşir. Bu olay için işleyici yoksa veya işleyici özelliğini olarak trueayarlarsaDataGridViewDataErrorEventArgs.ThrowException, bir özel durum oluşturulur.

Geçerliyse veya olay için DataError bir işleyici varsa ve özelliğini olarak trueDataGridView.CellFormatting ayarlamazsa valueDataGridViewDataErrorEventArgs.ThrowException, olay gerçekleşir.

Olay CellFormatting işleyicisi hem cellStylehem de value 'i değiştirebilir. Ancak işleyici özelliği olarak DataGridViewCellFormattingEventArgs.FormattingAppliedtrueayarlamazsa, bu yöntem nesnenin biçimlendirme özelliklerini cellStyle kullanarak biçimlendirmektedirvalue. Bu, ek DataError bir olaya neden olabilir.

Biçimlendirme başarılı olursa, bu yöntem denetimde DataGridView görüntülenmek üzere biçimlendirilmiş değeri döndürür.

Şunlara uygulanır

Ayrıca bkz.