DataGridViewCellParsingEventArgs Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan data untuk CellParsing peristiwa DataGridView kontrol.

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

Warisan: Object

EventArgs

ConvertEventArgs
DataGridViewCellParsingEventArgs

Contoh

Contoh kode berikut menunjukkan penggunaan DataGridViewCellParsingEventArgs untuk memeriksa validitas entri tanggal.

// 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

Keterangan

CellParsing Tangani peristiwa untuk memberikan konversi nilai kustom dari nilai yang ditentukan pengguna ke nilai dalam jenis yang ditentukan oleh properti selValueType.

Saat menangani CellParsing acara, Anda dapat mengonversi nilai sendiri atau anda dapat menyesuaikan konversi default. Misalnya, Anda dapat mengonversi nilai sendiri menggunakan metode sel ParseFormattedValue dengan pengonversi jenis yang Anda pilih. Secara bergantian, Anda dapat membiarkan pengonversi jenis default mengurai nilai, tetapi memodifikasi NullValueproperti , DataSourceNullValue, dan FormatProvider objek yang dikembalikan oleh DataGridViewCellParsingEventArgs.InheritedCellStyle properti , yang diinisialisasi menggunakan properti sel InheritedStyle .

Saat Anda mengonversi nilai sendiri, ganti nilai ConvertEventArgs.Value awal properti yang diformat dengan nilai yang dikonversi dalam jenis yang ditentukan oleh properti sel ValueType . Untuk menunjukkan bahwa tidak ada penguraian lebih lanjut yang diperlukan, atur properti ke DataGridViewCellParsingEventArgs.ParsingAppliedtrue.

Ketika penanganan aktivitas selesai, jika Value adalah null atau bukan jenis yang benar, atau ParsingApplied properti adalah false, Value diurai menggunakan metode sel ParseFormattedValue dengan pengonversi tipe default. Implementasi default metode ini mengurai nilai menggunakan NullValueproperti , DataSourceNullValue, dan FormatProvider dari gaya sel yang diteruskan. Jika nilainya tidak sama dengan NullValue, nilai diurai menggunakan FormatProvider properti dan pengonversi jenis yang diteruskan.

Untuk mengkustomisasi konversi nilai sel menjadi nilai yang diformat untuk ditampilkan, tangani CellFormatting peristiwa.

Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.

Konstruktor

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

Menginisialisasi instans baru kelas DataGridViewCellParsingEventArgs.

Properti

ColumnIndex	Mendapatkan indeks kolom data sel yang memerlukan penguraian.
DesiredType	Mendapatkan jenis data dari nilai yang diinginkan. (Diperoleh dari ConvertEventArgs)
InheritedCellStyle	Mendapatkan atau mengatur gaya yang diterapkan ke sel yang diedit.
ParsingApplied	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai sel telah berhasil diurai.
RowIndex	Mendapatkan indeks baris sel yang memerlukan penguraian.
Value	Mendapatkan atau menetapkan nilai .ConvertEventArgs (Diperoleh dari ConvertEventArgs)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui