DataGridViewCellParsingEventArgs クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

DataGridViewCellParsingEventArgs.cs

CellParsing コントロールの DataGridView イベントのデータを提供します。

public ref class DataGridViewCellParsingEventArgs : System::Windows::Forms::ConvertEventArgs

public class DataGridViewCellParsingEventArgs : System.Windows.Forms.ConvertEventArgs

type DataGridViewCellParsingEventArgs = class
    inherit ConvertEventArgs

Public Class DataGridViewCellParsingEventArgs
Inherits ConvertEventArgs

継承

Object

EventArgs

ConvertEventArgs

DataGridViewCellParsingEventArgs

例

次のコード例では、 を使用してDataGridViewCellParsingEventArgs日付エントリの有効性をチェックします。

// Handling CellParsing allows one to accept user input, then map it to a different
// internal representation.
void dataGridView1_CellParsing( Object^ /*sender*/, DataGridViewCellParsingEventArgs^ e )
{
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Release Date" ) )
   {
      if ( e != nullptr )
      {
         if ( e->Value != nullptr )
         {
            try
            {
               // Map what the user typed into UTC.
               e->Value = DateTime::Parse( e->Value->ToString() ).ToUniversalTime();

               // Set the ParsingApplied property to 
               // Show the event is handled.
               e->ParsingApplied = true;
            }
            catch ( FormatException^ /*ex*/ ) 
            {
               // Set to false in case another CellParsing handler
               // wants to try to parse this DataGridViewCellParsingEventArgs instance.
               e->ParsingApplied = false;
            }
         }
      }
   }
}

// Handling CellParsing allows one to accept user input, then map it to a different
// internal representation.
private void dataGridView1_CellParsing(object sender, DataGridViewCellParsingEventArgs e)
{
    if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Release Date")
    {
        if (e != null)
        {
            if (e.Value != null)
            {
                try
                {
                    // Map what the user typed into UTC.
                    e.Value = DateTime.Parse(e.Value.ToString()).ToUniversalTime();
                    // Set the ParsingApplied property to 
                    // Show the event is handled.
                    e.ParsingApplied = true;
                }
                catch (FormatException)
                {
                    // Set to false in case another CellParsing handler
                    // wants to try to parse this DataGridViewCellParsingEventArgs instance.
                    e.ParsingApplied = false;
                }
            }
        }
    }
}

' Handling CellParsing allows one to accept user input, then map it to a different
' internal representation.
Private Sub dataGridView1_CellParsing(ByVal sender As Object, _
    ByVal e As DataGridViewCellParsingEventArgs) _
    Handles dataGridView1.CellParsing

    If Me.dataGridView1.Columns(e.ColumnIndex).Name = _
        "Release Date" Then
        If e IsNot Nothing Then
            If e.Value IsNot Nothing Then
                Try
                    ' Map what the user typed into UTC.
                    e.Value = _
                    DateTime.Parse(e.Value.ToString()).ToUniversalTime()
                    ' Set the ParsingApplied property to 
                    ' Show the event is handled.
                    e.ParsingApplied = True

                Catch ex As FormatException
                    ' Set to false in case another CellParsing handler
                    ' wants to try to parse this DataGridViewCellParsingEventArgs instance.
                    e.ParsingApplied = False
                End Try
            End If
        End If
    End If
End Sub

注釈

イベントを CellParsing 処理して、ユーザー指定の値から cell ValueType プロパティで指定された型の値へのカスタム値変換を提供します。

イベントを CellParsing 処理するときは、値を自分で変換することも、既定の変換をカスタマイズすることもできます。 たとえば、選択した型コンバーターを使用して cell ParseFormattedValue メソッドを使用して、自分で値を変換できます。 または、既定の型コンバーターで値を解析できますが、 プロパティによってDataGridViewCellParsingEventArgs.InheritedCellStyle返されるオブジェクトの 、DataSourceNullValue、および FormatProvider プロパティを変更NullValueできます。このプロパティは、cell InheritedStyle プロパティを使用して初期化されます。

値を自分で変換するときは、プロパティの最初の書式設定された値を ConvertEventArgs.Value 、セル ValueType プロパティで指定された型の変換された値に置き換えます。 これ以上解析する必要がないことを示すには、 プロパティを DataGridViewCellParsingEventArgs.ParsingApplied に true設定します。

イベント ハンドラーが完了すると、 がnull正しい型であるか、または プロパティfalseValueが の場合Valueは、 が既定の型ParsingAppliedコンバーターを使用してセル ParseFormattedValue メソッドを使用して解析されます。 このメソッドの既定の実装では、渡されたセル スタイルの NullValue、 DataSourceNullValue、および FormatProvider プロパティを使用して値を解析します。 値が と NullValue等しくない場合、値は プロパティと渡された型コンバーターを使用して FormatProvider 解析されます。

セル値を表示用の書式設定された値に変換するようにカスタマイズするには、 イベントを処理します CellFormatting 。

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。

コンストラクター

DataGridViewCellParsingEventArgs(Int32, Int32, Object, Type, DataGridViewCellStyle)

DataGridViewCellParsingEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

ColumnIndex	解析を必要とするセル データの列インデックスを取得します。
DesiredType	必要な値のデータ型を取得します。 (継承元 ConvertEventArgs)
InheritedCellStyle	編集されたセルに適用されるスタイルを取得または設定します。
ParsingApplied	セルの値が正常に解析されたかどうかを示す値を取得または設定します。
RowIndex	解析を必要とするセルの行インデックスを取得します。
Value	ConvertEventArgs の値を取得します。値の設定も可能です。 (継承元 ConvertEventArgs)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• DataGridView
• CellParsing
• OnCellParsing(DataGridViewCellParsingEventArgs)
• CellFormatting
• EditMode
• ValueType
• InheritedStyle
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)
• DataGridViewCellParsingEventHandler
• Value
• InheritedCellStyle
• ParsingApplied
• DataGridViewCellStyle
• NullValue
• Format
• FormatProvider