Interfaccia ErrorAddDataBoundRowEventArgs

Articolo
01/06/2014

fornisce informazioni per ErrorAddDataBoundRow evento.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
<GuidAttribute("eca34a5d-a43c-4be4-a24a-49d49ae4519b")> _
Public Interface ErrorAddDataBoundRowEventArgs

[GuidAttribute("eca34a5d-a43c-4be4-a24a-49d49ae4519b")]
public interface ErrorAddDataBoundRowEventArgs

Il tipo ErrorAddDataBoundRowEventArgs espone i seguenti membri.

Proprietà

	Nome	Descrizione
	InnerException	ottiene Exception istanza di che ha causato l'eccezione corrente.
	Item	ottiene il nuovo elemento che ListObject ha tentato di aggiungere all'origine dati.
	Retry	Ottiene o imposta un valore che indica se ListObject deve tentare di aggiungere nuovamente l'elemento.

In alto

Note

ErrorAddDataBoundRow l'evento viene generato da ListObject controllare se si verifica un'eccezione durante il tentativo di aggiungere una nuova riga all'origine dati associata a ListObject. Item la proprietà può essere utilizzata per ottenere il nuovo elemento che ListObject è tentato di aggiungere. InnerException la proprietà fornisce eccezione generata e Retry la proprietà può essere utilizzata per indicare se un altro tentativo di aggiungere questa riga deve essere effettuata.

Esempi

Nell'esempio di codice riportato di seguito viene creato un oggetto DataTable e ListObjecte associazioni ListObject in DataTable. Crea quindi ErrorAddDataBoundRow gestore eventi. Per verificare l'evento, aggiungere manualmente una nuova riga a ListObject e il cognome “Chan„ e un nome. Il gestore eventi visualizza un messaggio.

Questo esempio è valido per una personalizzazione a livello di documento.

    WithEvents ErrorAddDataBoundRowList As _
        Microsoft.Office.Tools.Excel.ListObject
    Private Sub ListObject_ErrorAddDataBoundRow()
        ' 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"))

        Dim myUC As New UniqueConstraint("CustConstraint", _
            lastName)
        dt.Constraints.Add(myUC)

        ' Add a new row to the DataTable.
        Dim dr As DataRow = dt.NewRow()
        dr("LastName") = "Chan"
        dr("FirstName") = "Gareth"
        dt.Rows.Add(dr)

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

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


    Private Sub List1_ErrorAddDataBoundRow(ByVal sender As Object, _
        ByVal e As Microsoft.Office.Tools.Excel.ErrorAddDataBoundRowEventArgs) _
        Handles ErrorAddDataBoundRowList.ErrorAddDataBoundRow
        MessageBox.Show("Last names must be unique.")

    End Sub

private void ListObject_ErrorAddDataBoundRow()
{
    // 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"));

    UniqueConstraint myUC = new UniqueConstraint( "CustConstraint", 
        lastName);
    dt.Constraints.Add(myUC);

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // 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.ErrorAddDataBoundRow += new 
        Microsoft.Office.Tools.Excel.
        ErrorAddDataBoundRowEventHandler(list1_ErrorAddDataBoundRow);
}

void list1_ErrorAddDataBoundRow(object sender, 
    Microsoft.Office.Tools.Excel.ErrorAddDataBoundRowEventArgs e)
{
    MessageBox.Show("Last names must be unique.");
}

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via