ChangeReason – výčet

Článek
01/03/2014

Poskytuje z důvodu, že byla obnovena původní data ListObject vázané 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
	DataBoundColumnHeaderIsAutoSet	Při AutoSetDataBoundColumnHeaders vlastnost ListObject ovládacího prvku je nastavena na true, ListObject řízení neumožňuje uživateli změnit záhlaví sloupců.
	ErrorInCommit	Změna dat v ListObject řízení nelze potvrdit ke zdroji dat ovládací prvek svázaný.
	FixedLengthDataSource	Zdroje dat ListObject ovládací prvek vázán na 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.
	Other	Z důvodu není určeno žádné druhé byla obnovena původní data ChangeReason hodnoty.
	ReadOnlyDataSource	Zdroje dat ListObject je vázán ovládací prvek je určen jen pro čtení.

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í.ChangeReason Výčet obsahuje informace o proč tímto obnovením.

Příklady

Následující příklad kódu vytváří DataTable a ListObjecta připojí ListObject do DataTable.Poté vytvoří OriginalDataRestored obslužnou rutinu události.Otestujte událost, klepněte pravým tlačítkem myši písmene sloupce ListObject na 1 list a klepněte na tlačítko Odstranit v místní nabídce.Obslužná rutina události nahrazuje sloupce a data záhlaví 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"], "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é

Referenční dokumentace

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

Sdílet prostřednictvím