DataGridViewCell.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ücrenin değerini görüntüleme için biçimlendirilmiş olarak alır.
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
Parametreler
- value
- Object
Biçimlendirilecek değer.
- rowIndex
- Int32
Hücrenin üst satırının dizini.
- cellStyle
- DataGridViewCellStyle
Hücrenin DataGridViewCellStyle etkisi.
- 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
TypeConverter Değer 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
Hücrenin biçimlendirilmiş değeri veya null
hücre bir DataGridView denetime ait değilse.
Özel durumlar
Biçimlendirme başarısız oldu ve denetimin DataErrorDataGridView olayı için işleyici yok veya işleyici özelliğini olarak true
ayarladıThrowException. Özel durum nesnesi genellikle türüne FormatExceptionyayınlanabilir.
Açıklamalar
Denetim, DataGridView bir hücre değerini özelliği tarafından FormattedValueType belirtilen türde 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 olayı tetikler DataGridView.CellFormatting . Bu olayın işleyicisi hem hem cellStyle
de value
parametrelerini değiştirebilir. Öte yandan işleyici özelliği olarak ayarlamazsaDataGridViewCellFormattingEventArgs.FormattingApplied, bu yöntem nesnesinin biçimlendirme özelliklerini kullanarak biçimlendirmektedir value
cellStyle
.true
Not
Bu yöntem, veya null
dışında bir değere DataGridViewCellStyle.NullValue ayarlandığında özellik değerine DataSourceNullValue eşit DataGridViewCellStyle.DataSourceNullValue değerler için özellik değerine dönüştürmez value
DBNull.Value. Bu durumda, özellik değerini görüntülemek NullValue için olayı işleyebilirsinizDataGridView.CellFormatting. Daha fazla bilgi için içindeki kod örneğine DataSourceNullValuebakın.
Biçimlendirme başarısız olursa, 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.
Bağımsız değişken değeri içeriyorsa, bu yöntemi geçersiz kılan türetilmiş sınıflar genellikle hücre değerinin context
dize gösterimini ClipboardContent döndürür.
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin