Enumeração ChangeType

Fornece informações sobre como um ListObject controlar os dados restaurados que foi alterados por um usuário.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Public Enumeration ChangeType

public enum ChangeType

Membros

	Nome do membro	Descrição
	ColumnAdded	Foi adicionada uma coluna para o ListObject controle.
	ColumnHeaderRestored	O texto do cabeçalho da coluna foi restaurado para seu valor original.
	ColumnRemoved	Uma coluna foi removida do ListObject controle.
	RangeValueRestored	Os valores em um intervalo foram restaurados aos valores na fonte de dados.
	RowAdded	Uma linha foi adicionada para a ListObject controle.
	RowRemoved	Uma linha foi removida da ListObject controle.

Comentários

Quando o ListObject controle está vinculado a dados e o usuário executa uma operação que não é permitida, o ListObject controle restaura próprio estado anterior e gera a OriginalDataRestored evento. O ChangeType enumeração fornece informações sobre o tipo de restauração que ocorreu.

Exemplos

O exemplo de código a seguir cria um DataTable e um ListObjecte vincula o ListObject para o DataTable. Em seguida, cria um OriginalDataRestored manipulador de eventos. Para testar o evento, clique com o botão direito uma letra de coluna acima de ListObject na planilha 1 e, em seguida, clique em Excluir no menu de atalho. O manipulador de eventos substitui a coluna e os dados de cabeçalho de coluna e exibe uma mensagem indicando o tipo de dados foi restaurado e o motivo que os dados originais foi restaurados.

Este exemplo é para uma personalização em nível de documento.

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

Consulte também

Referência

Namespace Microsoft.Office.Tools.Excel