DataGridViewComboBoxCell.GetFormattedValue Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 true
ayarladı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
veya koleksiyonunda DataSourceItems bulunur.value
veya DBNull.Valueşeklindedirnull
.value
ValueType ve String.Empty özellik değeri türü temsil ederString.
value
Geçerli değilse, DataGridView.DataError olay gerçekleşir. Bu olay için işleyici yoksa veya işleyici özelliğini olarak true
ayarlarsaDataGridViewDataErrorEventArgs.ThrowException, bir özel durum oluşturulur.
Geçerliyse veya olay için DataError bir işleyici varsa ve özelliğini olarak true
DataGridView.CellFormatting ayarlamazsa value
DataGridViewDataErrorEventArgs.ThrowException, olay gerçekleşir.
Olay CellFormatting işleyicisi hem cellStyle
hem de value
'i değiştirebilir. Ancak işleyici özelliği olarak DataGridViewCellFormattingEventArgs.FormattingAppliedtrue
ayarlamazsa, 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.
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)