語言

連線事件

所有 .NET Framework 的資料提供者都有 Connection 包含兩個事件的物件,你可以用來從資料來源擷取資訊訊息,或判斷 的 Connection 狀態是否改變。 下表描述了該 Connection 物體的事件。

事件 說明
InfoMessage 發生於從數據源傳回參考訊息時。 訊息型資訊是從數據源產生的,不會導致例外狀況發生。
StateChange 當 Connection 的狀態改變時發生。

使用 InfoMessage 事件

您可以使用 InfoMessage 物件的 SqlConnection 事件,從 SQL Server 數據源擷取警告和資訊訊息。 從嚴重性層級為 11 到 16 的數據源傳回的錯誤,會導致擲回例外狀況。 不過, InfoMessage 事件可用來從與錯誤無關的數據源取得訊息。 在 Microsoft SQL Server 中,任何嚴重性為 10 或以下的錯誤均被視為資訊性訊息,可以使用 InfoMessage 事件來擷取。 如需詳細資訊,請參閱 資料庫引擎 錯誤嚴重性 一文。

事件 InfoMessage 接收 SqlInfoMessageEventArgs 一個物件,其屬性中 Errors 包含來自資料來源的訊息集合。 你可以查詢 Error 此集合中的物件錯誤編號、訊息文字,以及錯誤來源。 Microsoft.Data.SqlClient 也包含關於該訊息來源的資料庫、儲存程序及行號的詳細資訊。

範例

下列程式碼範例顯示如何為 InfoMessage 事件添加事件處理程式。

' Assumes that connection represents a SqlConnection object.
  AddHandler connection.InfoMessage, _
    New SqlInfoMessageEventHandler(AddressOf OnInfoMessage)

Private Shared Sub OnInfoMessage(sender As Object, _
  args As SqlInfoMessageEventArgs)
  Dim err As SqlError
  For Each err In args.Errors
    Console.WriteLine("The {0} has received a severity {1}, _
       state {2} error number {3}\n" & _
      "on line {4} of procedure {5} on server {6}:\n{7}", _
      err.Source, err.Class, err.State, err.Number, err.LineNumber, _
    err.Procedure, err.Server, err.Message)
  Next
End Sub
// Assumes that connection represents a SqlConnection object.
  connection.InfoMessage +=
    new SqlInfoMessageEventHandler(OnInfoMessage);

protected static void OnInfoMessage(
  object sender, SqlInfoMessageEventArgs args)
{
  foreach (SqlError err in args.Errors)
  {
    Console.WriteLine(
  "The {0} has received a severity {1}, state {2} error number {3}\n" +
  "on line {4} of procedure {5} on server {6}:\n{7}",
   err.Source, err.Class, err.State, err.Number, err.LineNumber,
   err.Procedure, err.Server, err.Message);
  }
}

以資訊消息處理錯誤

InfoMessage事件通常只會針對從伺服器傳送的資訊和警告訊息引發。 然而,當實際發生錯誤時,啟動伺服器操作的 ExecuteNonQuery or ExecuteReader 方法執行會被停止並拋出例外。

如果您要繼續處理命令中的其餘語句,而不論伺服器所產生的任何錯誤,請將的 FireInfoMessageEventOnUserErrors 屬性設定SqlConnection為 true。 這樣做會導致連線引發InfoMessage錯誤事件,而不是拋出例外狀況並中斷處理。 用戶端應用程式接著可以處理此事件並回應錯誤狀況。

備註

錯誤的嚴重性層級為 17 或以上,導致伺服器停止處理命令時,必須作為例外狀況來處理。 在此情況下,不論事件 InfoMessage 中如何處理錯誤,都仍然會丟出例外狀況。

使用 StateChange 事件

StateChange事件發生於 的Connection狀態改變時。 StateChange事件會接收StateChangeEventArgs,讓你可以透過Connection和OriginalState屬性來判斷CurrentState狀態的變化。 屬性 OriginalState 是一個 ConnectionState 列舉,表示在 Connection 改變之前的狀態。 CurrentState 是一種 ConnectionState 枚舉,用於表示 Connection 改變後的狀態。

以下程式碼範例利用事件 StateChange 在狀態 Connection 改變時寫訊息給主控台。

' Assumes connection represents a SqlConnection object.
  AddHandler connection.StateChange, _
    New StateChangeEventHandler(AddressOf OnStateChange)

Protected Shared Sub OnStateChange( _
  sender As Object, args As StateChangeEventArgs)

  Console.WriteLine( _
  "The current Connection state has changed from {0} to {1}.", _
  args.OriginalState, args.CurrentState)
End Sub
// Assumes connection represents a SqlConnection object.
  connection.StateChange  += new StateChangeEventHandler(OnStateChange);

protected static void OnStateChange(object sender,
  StateChangeEventArgs args)
{
  Console.WriteLine(
    "The current Connection state has changed from {0} to {1}.",
      args.OriginalState, args.CurrentState);
}

另請參閱