本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

ErrorAddDataBoundRowEventArgs 介面

 

提供 ErrorAddDataBoundRow 事件的資訊。

命名空間:   Microsoft.Office.Tools.Excel
組件:  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

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

名稱描述
System_CAPS_pubpropertyInnerException

取得造成目前例外狀況的 Exception 執行個體。

System_CAPS_pubpropertyItem

取得 ListObject 嘗試加入至資料來源的新項目。

System_CAPS_pubpropertyRetry

取得或設定值,表示 ListObject 是否應該嘗試再次加入此項目。

如果嘗試加入一個新資料列至與 ListObject 繫結的資料來源,而發生例外狀況,ListObject 控制項會引發 ErrorAddDataBoundRow 事件。 Item 屬性可用來取得 ListObject 嘗試加入的新項目。 InnerException 屬性提供擲回的例外狀況,而 Retry 屬性可用來指出是否應該讓另一個嘗試加入此資料列的行為成功的執行。

下列程式碼範例會建立 DataTableListObject,並將 ListObject 繫結至 DataTable接著會建立 ErrorAddDataBoundRow 事件處理常式。若要測試此事件,請以手動方式加入一個新資料列至 ListObject,並輸入姓氏 "Chan" 和名字。此事件處理常式會顯示一個訊息。

這是示範文件層級自訂的範例。

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.");
}
回到頁首
顯示: