DataGridViewCell.ParseFormattedValue 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將為了顯示而格式化的值轉換成實際的儲存格值。

public:
 virtual System::Object ^ ParseFormattedValue(System::Object ^ formattedValue, System::Windows::Forms::DataGridViewCellStyle ^ cellStyle, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::ComponentModel::TypeConverter ^ valueTypeConverter);

public virtual object ParseFormattedValue (object formattedValue, System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.ComponentModel.TypeConverter valueTypeConverter);

abstract member ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj
override this.ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj

Public Overridable Function ParseFormattedValue (formattedValue As Object, cellStyle As DataGridViewCellStyle, formattedValueTypeConverter As TypeConverter, valueTypeConverter As TypeConverter) As Object

參數

formattedValue

Object

儲存格的顯示值。

cellStyle

DataGridViewCellStyle

DataGridViewCellStyle 對儲存格有作用。

formattedValueTypeConverter

TypeConverter

TypeConverter 表示顯示值的型別，null 則表示使用預設轉換子。

valueTypeConverter

TypeConverter

TypeConverter 表示儲存格值的型別，null 則表示使用預設轉換子。

傳回

Object

儲存格值。

例外狀況

ArgumentNullException

cellStyle 為 null。

FormatException

FormattedValueType 屬性值為 null。

-或-

ValueType 屬性值為 null。

-或-

無法轉換 formattedValue。

ArgumentException

formattedValue 為 null。

-或-

formattedValue 的型別不符合 FormattedValueType 屬性所指的型別。

備註

當使用者編輯儲存格值並認可變更時， DataGridView 控制項會呼叫這個方法，將顯示的值從 FormattedValueTypeValueType 轉換為 。 控制項接著會將基礎資料格值或資料來源值設定為已轉換的值。

這個方法的預設實作會使用 NullValue 參數所指示 cellStyle 之儲存格樣式的 、 DataSourceNullValue 和 FormatProvider 屬性來剖析 formattedValue 參數。

如果 formattedValue 等於 NullValue ，則這個方法會傳回 屬性的值 DataSourceNullValue ，或者 null 如果 DataSourceNullValue 是 DBNull.Value ，而且儲存格 ValueType 是參考型別。

如果 formattedValue 不等於 NullValue ，這個方法會使用 FormatProvider 屬性和指定的或預設轉換器來剖析 formattedValue 。

如果儲存格 ValueType 可為 Null，這個方法會將傳回值包裝為 Nullable<T> 類型。

另請參閱

• DataGridView
• DataGridViewCellStyle
• NullValue
• DataSourceNullValue
• FormatProvider
• ValueType
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• Nullable<T>
• 可為 Null 的類型 (C# 程式設計手冊)
• 可為 Null 的實值類型 (Visual Basic)