共用方式為


在網路連線中斷時安全地關閉和中止釋放資源

UsingUsing 範例會示範如何使用 CloseAbort 方法在使用具型別用戶端時清除資源。 using 陳述式會在網路連線不健全時造成例外狀況。 這個範例是以實作計算機服務的使用者入門範例為基礎。 在這個範例中,用戶端是主控台應用程式 (.exe),而服務則是由網際網路資訊服務 (IIS) 所裝載。

注意

此範例的安裝程序與建置指示位於本主題的結尾。

這個範例會說明兩個當 C# "using" 陳述式使用於具型別用戶端時發生的常見問題,並示範在例外狀況之後正確進行清除的程式碼。

C# "using" 陳述式會產生對 Dispose() 的呼叫。 這就跟呼叫 Close() 一樣,可能會在發生網路錯誤時擲回例外狀況。 因為對 Dispose() 的呼叫會隱含地發生在 "using" 區塊的右邊大括號,所以撰寫和閱讀程式碼的人可能都不會注意到這個例外狀況來源。 這代表應用程式錯誤的潛在來源。

要在 DemonstrateProblemUsingCanThrow 方法中說明的第一個問題,是右大括號會擲回例外狀況,而且右大括號之後的程式碼不會執行:

using (CalculatorClient client = new CalculatorClient())
{
    ...
} // <-- this line might throw
Console.WriteLine("Hope this code wasn't important, because it might not happen.");

即使在 using 區塊中沒有任何程式碼擲回例外狀況,或是已攔截到 using 區塊內的所有例外狀況,但 Console.WriteLine 可能仍然不執行,這是因為右大括號所隱含的 Dispose() 呼叫可能擲回了例外狀況。

要在 DemonstrateProblemUsingCanThrowAndMask 方法中說明的第二個問題,則是右大括號的另一個會擲回例外狀況的隱含動作:

using (CalculatorClient client = new CalculatorClient())
{
    ...
    throw new ApplicationException("Hope this exception was not important, because "+
                                   "it might be masked by the Close exception.");
} // <-- this line might throw an exception.

因為 Dispose() 會在 "finally" 區塊內發生,如果 ApplicationException() 失敗,則永遠無法在 using 區塊之外見到 Dispose。 如果區塊外面的程式碼必須知道 ApplicationException 何時發生,"using" 建構便可能因為遮罩了這個例外狀況而造成問題。

最後,範例會在 DemonstrateCleanupWithExceptions 中示範如何於例外狀況發生時正確清除。 這段程式碼會使用 try/catch 區塊,報告錯誤並呼叫 Abort。 如需快取用戶端呼叫所造成之例外狀況的詳細資訊,請參閱預期的例外狀況範例。

try
{
    ...
    client.Close();
}
catch (CommunicationException e)
{
    ...
    client.Abort();
}
catch (TimeoutException e)
{
    ...
    client.Abort();
}
catch (Exception e)
{
    ...
    client.Abort();
    throw;
}

注意

using語句和 ServiceHost:許多自我裝載應用程式只能裝載服務,而且ServiceHost.Close很少擲回例外狀況,因此這類應用程式可以安全地搭配 ServiceHost使用 using 語句。 不過,請注意 ServiceHost.Close ,可以擲回 CommunicationException,因此如果您的應用程式在關閉 ServiceHost之後繼續,您應該避免 using 語句,並遵循先前指定的模式。

當您執行範例時,作業回應和例外狀況會顯示在用戶端主控台視窗中。

用戶端處理序將執行三個案例,其中每一個都會嘗試呼叫 Divide。 第一個案例示範因 Dispose() 發生例外狀況而略過程式碼的情況。 第二個案例示範因 Dispose() 發生例外狀況而遮罩了重要例外狀況的情況。 第三個案例則示範進行正確清除。

從用戶端處理序產生的預期輸出如下:

=
= Demonstrating problem:  closing brace of using statement can throw.
=
Got System.ServiceModel.CommunicationException from Divide.
Got System.ServiceModel.Security.MessageSecurityException
=
= Demonstrating problem:  closing brace of using statement can mask other Exceptions.
=
Got System.ServiceModel.CommunicationException from Divide.
Got System.ServiceModel.Security.MessageSecurityException
=
= Demonstrating cleanup with Exceptions.
=
Calling client.Add(0.0, 0.0);
        client.Add(0.0, 0.0); returned 0
Calling client.Divide(0.0, 0.0);
Got System.ServiceModel.CommunicationException from Divide.

Press <ENTER> to terminate client.

若要安裝、建置及執行範例

  1. 確定您已執行 Windows Communication Foundation 範例的一次性安裝程序

  2. 若要建置方案的 C# 或 Visual Basic .NET 版本,請遵循 Building the Windows Communication Foundation Samples中的指示。

  3. 若要在單一或多部電腦組態中執行此範例,請遵循執行 Windows Communication Foundation 範例中的指示進行。