LinqDataSourceStatusEventArgs 類別

定義

public ref class LinqDataSourceStatusEventArgs : EventArgs

public class LinqDataSourceStatusEventArgs : EventArgs

type LinqDataSourceStatusEventArgs = class
    inherit EventArgs

Public Class LinqDataSourceStatusEventArgs
Inherits EventArgs

繼承

Object

EventArgs

LinqDataSourceStatusEventArgs

範例

下列範例顯示事件的事件處理常式 Inserted 。The following example shows an event handler for the Inserted event. 在事件處理常式中，如果 Exception 屬性為 null ，則會從屬性中的物件取出產品識別碼 Result 。In the event handler, if the Exception property is null, the product ID is retrieved from the object in the Result property. 產品識別碼是資料表的主鍵，而且是由資料庫所設定，因此在插入作業完成之前，不會知道此值。The product ID is a primary key for the table and is set by the database, therefore the value is not known until the insert operation has finished. 如果屬性不等於，則會記錄例外狀況訊息 Exception null 。The exception message is logged if the Exception property is not equal to null. ExceptionHandled然後，屬性會設定為 true 。The ExceptionHandled property is then set to true.

protected void LinqDataSource_Inserted(object sender, LinqDataSourceStatusEventArgs e)
{
    if (e.Exception == null)
    {
        Product newProduct = (Product)e.Result;
        Literal1.Text = "The new product id is " + newProduct.ProductID;
        Literal1.Visible = true;            
    }
    else
    {
        LogError(e.Exception.Message);
        Literal1.Text = "We are sorry. There was a problem saving the record. The administrator has been notified.";
        Literal1.Visible = true;
        e.ExceptionHandled = true;            
    }
}

Protected Sub LinqDataSource_Inserted(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceStatusEventArgs)
    If (IsNothing(e.Exception)) Then
        Dim newProduct As Product
        newProduct = CType(e.Result, Product)
        Literal1.Text = "The new product id is " & newProduct.ProductID
        Literal1.Visible = True
    Else
        LogError(e.Exception.Message)
        Literal1.Text = "We are sorry. There was a problem saving the record. The administrator has been notified."
        Literal1.Visible = True
        e.ExceptionHandled = True
    End If
End Sub

備註

LinqDataSourceStatusEventArgs類別可讓您檢查控制項所執行的資料作業結果 LinqDataSource 。The LinqDataSourceStatusEventArgs class enables you to examine the results of data operations that have been performed by a LinqDataSource control. LinqDataSourceStatusEventArgs物件會傳遞至 ContextCreated 控制項的、、 Deleted Inserted 、 Selected 和 Updated 事件 LinqDataSource 的事件處理常式。A LinqDataSourceStatusEventArgs object is passed to event handlers for the ContextCreated, Deleted, Inserted, Selected, and Updated events of the LinqDataSource control.

如果資料作業順利完成，則產生的資料物件會儲存在屬性中， Result 且 Exception 屬性為 null 。If the data operation completed successfully, the resulting data object is stored in the Result property and the Exception property is null. 如果資料作業失敗，則在資料作業期間發生的例外狀況會儲存在屬性中， Exception 且 Result 屬性為 null 。If the data operation failed, the exception that occurred during the data operation is stored in the Exception property and the Result property is null. 如果您已處理由屬性工作表示的例外狀況 Exception ，請將屬性設定為，如此就不會擲回 ExceptionHandled true 例外狀況。If you handled the exception represented by the Exception property, set the ExceptionHandled property to true so that the exception will not be thrown.

您可以透過屬性來取得查詢所傳回的資料記錄總數 TotalRowCount 。You retrieve the total number of data records returned from a query through the TotalRowCount property.

建構函式

屬性

方法

適用於