مشاركة عبر


ChangeReason قائمة تعداد

توفير سبب أنه تم استرداد بيانات الأصلية إلى ListObjectهو حدود للبيانات.

مساحة الاسم:  Microsoft.Office.Tools.Excel
التجميع:  Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)

بناء الجملة

'إقرار
Public Enumeration ChangeReason
public enum ChangeReason

الأعضاء

اسم العضو الوصف
ReadOnlyDataSource مصدر بيانات الذي ListObjectعنصر التحكم هو مرتبطة ب هو القراءة فقط.
FixedLengthDataSource مصدر بيانات الذي ListObjectعنصر التحكم هو المنضم لا تسمح بإضافة أو إزالة صفوف.
FixedNumberOfColumnsInDataBoundList ListObjectلا يسمح عنصر التحكم أعمدة المراد إضافتها أو إزالتها بعد ذلك هو مرتبط بالبيانات.
DataBoundColumnHeaderIsAutoSet عند AutoSetDataBoundColumnHeadersخاصية ListObjectعنصر التحكم هو تعيين إلى true، ListObjectلا يسمح عنصر تحكم مستخدم بتغيير رؤوس الأعمدة.
ErrorInCommit تغيير بيانات في ListObjectتعذر تسليم عنصر تحكم مصدر البيانات الذي عنصر التحكم هو مرتبطة ب.
Other تمت استعادة بيانات الأصلية نظراً لسبب ما لم يتم تحديد أي من الآخرين ChangeReasonقيم.

ملاحظات

عند ListObjectهو حدود للبيانات ومستخدم يقوم بإجراء عملية غير مسموح بها، ListObjectيستعيد نفسه إلى حالته السابقة ورفع OriginalDataRestoredحدث. ChangeReasonالتعداد بتوفير معلومات حول سبب حدوث هذه الاستعادة.

أمثلة

إنشاء مثال التعليمة البرمجية التالية على DataTableو ListObject، وربطها ListObjectإلى DataTable. ثم إنشاء عنصر OriginalDataRestoredمعالج حدث. إلى اختبار حدث، انقر نقراً مزدوجاً فوق حرف عمود أعلاه ListObjectتشغيل الورقة 1 ثم انقر فوق يحذف في قائمة المختصرة. يستبدل hوler حدث العمود و بيانات عنوان العمود و يعرض رسالة تشير إلى نوع بيانات التي تم استعادتها و السبب أنه تمت استعادة بيانات الأصلية.

Th هو المثال هو لتخصيص المستوى مستند.

    WithEvents OriginalDataRestoredList As _
        Microsoft.Office.Tools.Excel.ListObject
    Private Sub ListObject_OriginalDataRestored()
        ' Create a new DataSet and DataTable.
        Dim ds As New DataSet()
        Dim dt As DataTable = ds.Tables.Add("Customers")
        Dim lastName As New DataColumn("LastName")
        dt.Columns.Add(lastName)
        dt.Columns.Add(New DataColumn("FirstName"))

        ' Add two new rows to the DataTable.
        Dim dr1 As DataRow = dt.NewRow()
        dr1("LastName") = "Chan"
        dr1("FirstName") = "Gareth"
        dt.Rows.Add(dr1)
        Dim dr2 As DataRow = dt.NewRow()
        dr2("LastName") = "Nitsche"
        dr2("FirstName") = "Sonja"
        dt.Rows.Add(dr2)

        ' Create a list object.
        OriginalDataRestoredList = Me.Controls.AddListObject( _
            Me.Range("A1"), "OriginalDataRestoredList")

        ' Bind the list object to the DataTable.
        OriginalDataRestoredList.AutoSetDataBoundColumnHeaders = True
        OriginalDataRestoredList.SetDataBinding(ds, "Customers", _
            "LastName", "FirstName")
    End Sub

    Private Sub List1_OriginalDataRestored(ByVal sender As Object, _
        ByVal e As Microsoft.Office.Tools.Excel.OriginalDataRestoredEventArgs) _
        Handles OriginalDataRestoredList.OriginalDataRestored
        MessageBox.Show("This data is bound to a data source and " & _
        "will be restored. This change is: " & e.ChangeType.ToString() & _
        ". The reason is: " & e.ChangeReason.ToString() + ".")
    End Sub

private void ListObject_OriginalDataRestored()
{
    // Create a new DataSet and DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    DataColumn lastName = new DataColumn("LastName");
    dt.Columns.Add(lastName);
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add two new rows to the DataTable.
    DataRow dr1 = dt.NewRow();
    dr1["LastName"] = "Chan";
    dr1["FirstName"] = "Gareth";
    dt.Rows.Add(dr1);
    DataRow dr2 = dt.NewRow();
    dr2["LastName"] = "Nitsche";
    dr2["FirstName"] = "Sonja";
    dt.Rows.Add(dr2);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1", missing], "list1");

    // Bind the list object to the DataTable.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.SetDataBinding(ds, "Customers", "LastName",
        "FirstName");

    // Create the event handler.
    list1.OriginalDataRestored += new 
        Microsoft.Office.Tools.Excel.
        OriginalDataRestoredEventHandler(list1_OriginalDataRestored);
}

void list1_OriginalDataRestored(object sender, 
    Microsoft.Office.Tools.Excel.OriginalDataRestoredEventArgs e)
{
    MessageBox.Show("This data is bound to a data source and " +
    "will be restored. This change is: " + e.ChangeType.ToString() +
    ". The reason is: " + e.ChangeReason.ToString() + ".");
}

راجع أيضًَا

المرجع

Microsoft.Office.Tools.Excel مساحة الاسم