Wyliczenie ChangeReason

Powodem, dla którego został przywrócony oryginalny danych zawiera ListObject który jest powiązany z danymi.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
Public Enumeration ChangeReason

public enum ChangeReason

Elementy członkowskie

	Nazwa elementu członkowskiego	Opis
	DataBoundColumnHeaderIsAutoSet	Gdy AutoSetDataBoundColumnHeaders właściwość ListObject formantu została ustawiona na true, ListObject kontroli nie zezwala użytkownikowi na zmianę nagłówki kolumn.
	ErrorInCommit	Zmiana danych w ListObject formantu nie można zadeklarować do źródła danych, że formant jest powiązany.
	FixedLengthDataSource	Źródło danych ListObject formantem nie zezwala na dodawanie lub usuwanie wierszy.
	FixedNumberOfColumnsInDataBoundList	ListObject Kontroli nie zezwala na kolumny, które mają być dodane lub usunięte po jest powiązany z danymi.
	Other	Oryginalne dane został przywrócony z powodu, nie jest określony przez żadną z drugiej strony ChangeReason wartości.
	ReadOnlyDataSource	Źródło danych ListObject formant jest związany jest tylko do odczytu.

Uwagi

Gdy ListObject jest powiązany z danymi i użytkownik wykonuje operację, która nie jest dozwolone, ListObject przywraca się do jego poprzedniego stanu i podnosi OriginalDataRestored zdarzenia.ChangeReason Wyliczenie zawiera informacje dotyczące Dlaczego wystąpiło to przywracanie.

Przykłady

Poniższy kod ilustruje tworzenie DataTable i ListObjecti powiąże ListObject do DataTable.Następnie tworzy OriginalDataRestored programu obsługi zdarzeń.Aby przetestować zdarzenie, kliknij prawym przyciskiem myszy literę kolumny powyżej ListObject na arkuszu 1, a następnie kliknij przycisk usunąć w menu skrótów.Obsługa zdarzeń zastępuje kolumny i dane nagłówka kolumny i wyświetla komunikat informujący o rodzaju danych został przywrócony i powód przywrócono oryginalnych danych.

W tym przykładzie jest przejmowane poziomie dokumentu.

    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"], "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() + ".");
}

Zobacz też

Informacje

Przestrzeń nazw Microsoft.Office.Tools.Excel