DataGridViewCell.ParseFormattedValue メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewCell.ParseFormattedValue メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

表示用に書式設定された値を、実際のセル値に変換します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As DataGridViewCell
Dim formattedValue As Object
Dim cellStyle As DataGridViewCellStyle
Dim formattedValueTypeConverter As TypeConverter
Dim valueTypeConverter As TypeConverter
Dim returnValue As Object

returnValue = instance.ParseFormattedValue(formattedValue, cellStyle, formattedValueTypeConverter,
 valueTypeConverter)

C#

public virtual Object ParseFormattedValue (
    Object formattedValue,
    DataGridViewCellStyle cellStyle,
    TypeConverter formattedValueTypeConverter,
    TypeConverter valueTypeConverter
)

C++

public:
virtual Object^ ParseFormattedValue (
    Object^ formattedValue, 
    DataGridViewCellStyle^ cellStyle, 
    TypeConverter^ formattedValueTypeConverter, 
    TypeConverter^ valueTypeConverter
)

J#

public Object ParseFormattedValue (
    Object formattedValue, 
    DataGridViewCellStyle cellStyle, 
    TypeConverter formattedValueTypeConverter, 
    TypeConverter valueTypeConverter
)

JScript

public function ParseFormattedValue (
    formattedValue : Object, 
    cellStyle : DataGridViewCellStyle, 
    formattedValueTypeConverter : TypeConverter, 
    valueTypeConverter : TypeConverter
) : Object

パラメータ

formattedValue

セルの表示値。

cellStyle

セルに反映される DataGridViewCellStyle。

formattedValueTypeConverter

表示値の型の TypeConverter。既定のコンバータを使用する場合は null 参照 (Visual Basic では Nothing)。

valueTypeConverter

セル値の型の TypeConverter。既定のコンバータを使用する場合は null 参照 (Visual Basic では Nothing)。

戻り値
セル値。

例外

例外の種類	条件
ArgumentNullException	cellStyle が null 参照 (Visual Basic では Nothing) です。
FormatException	FormattedValueType プロパティ値が null 参照 (Visual Basic では Nothing) です。 または ValueType プロパティ値が null 参照 (Visual Basic では Nothing) です。 または formattedValue は変換できません。
ArgumentException	formattedValue が null 参照 (Visual Basic では Nothing) です。 または formattedValue の型が、FormattedValueType プロパティで示される型と一致しません。

解説

ユーザーがセルの値を編集して変更内容をコミットすると、DataGridView コントロールはこのメソッドを呼び出して、表示用の値を FormattedValueType から ValueType に変換します。その後、コントロールは、基になるセルの値またはデータ ソースの値を変換された値に設定します。

このメソッドの既定の実装は、cellStyle パラメータで示されるセル スタイルの NullValue、DataSourceNullValue、および FormatProvider の各プロパティを使用して、formattedValue パラメータを解析します。

formattedValue が NullValue に等しい場合、このメソッドは、DataSourceNullValue プロパティの値を返します。または、DataSourceNullValue が DBNull.Value で、セルの ValueType が参照型の場合は null 参照 (Visual Basic では Nothing) を返します。

formattedValue が NullValue に等しくない場合、このメソッドは、FormatProvider プロパティおよび指定されたコンバータか既定のコンバータを使用して、formattedValue を解析します。

セルの ValueType が INullableValue インターフェイスを実装している場合、このメソッドは、戻り値を Nullable 型にラップします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCell クラス
DataGridViewCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewCellStyle
DataGridViewCellStyle.NullValue
DataGridViewCellStyle.DataSourceNullValue
DataGridViewCellStyle.FormatProvider
ValueType
GetFormattedValue
INullableValue
Nullable