DataGridViewCell.GetFormattedValue Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Ö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

Object

Hücrenin biçimlendirilmiş değeri veya null hücre bir DataGridView denetime ait değilse.

Özel durumlar

Exception

Biçimlendirme başarısız oldu ve denetimin DataError DataGridView olayı için işleyici yok veya işleyici özelliğini olarak trueayarladı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 valuecellStyle.true

Not

Bu yöntem, veya nulldışı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 valueDBNull.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 trueayarlarsaDataGridViewDataErrorEventArgs.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