ChangeReason – výčet

Článek
08/11/2011

Důvodem byla obnovena původní data poskytuje ListObject , je vázán na data.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
Public Enumeration ChangeReason

public enum ChangeReason

Členy

	Název členu	Popis
	ReadOnlyDataSource	zdroj dat , ListObject je vázán ovládací prvek je jen pro čtení.
	FixedLengthDataSource	zdroj dat , ListObject ovládací prvek je svázán neumožňuje přidání nebo odebrání řádků.
	FixedNumberOfColumnsInDataBoundList	ListObject Řízení neumožňuje sloupců přidána nebo odebrána po je vázán na data.
	DataBoundColumnHeaderIsAutoSet	Když AutoSetDataBoundColumnHeaders vlastnost ListObject ovládací prvek nastavena na true, ListObject řízení neumožňuje uživatel změnit záhlaví sloupce.
	ErrorInCommit	Změna dat v ListObject řízení může být potvrzena zdroj dat , který je ovládací prvek vázán na.
	Other	Byla obnovena původní data z důvodu není určeno žádné ostatních ChangeReason hodnoty.

Poznámky

Při ListObject je vázán na data a uživatel provede operaci, která není povolena, ListObject sama obnoví předchozí stav a vyvolává OriginalDataRestored událost. ChangeReasonvýčet obsahuje informace o proč došlo k obnovení.

Příklady

Následující příklad kódu vytváří DataTable a ListObjecta připojí ListObject se DataTable. Poté vytvoří OriginalDataRestored obslužnou rutinu události. test událost, klepněte pravým tlačítkem myši písmene sloupce ListObject na 1 list a potom klepněte na Odstranit v zástupcenabídka. Obslužná rutina událost nahrazuje sloupce a data hlavička sloupce a zobrazí zprávu, jaký druh dat byla obnovena a z důvodu, že byla obnovena původní data.

Tento příklad je přizpůsobení úrovni 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", 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() + ".");
}

Viz také

Odkaz

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím