DataProviderException 類別

表示所發生的例外狀況，如果有 DDEX 提供者發生了未預期的問題，例如遺漏或無效的登入或支援實體。

繼承階層架構

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

命名空間：  Microsoft.VisualStudio.Data.Core
組件：  Microsoft.VisualStudio.Data.Core (在 Microsoft.VisualStudio.Data.Core.dll 中)

語法

'宣告
<SerializableAttribute> _
Public MustInherit Class DataProviderException _
    Inherits Exception

[SerializableAttribute]
public abstract class DataProviderException : Exception

[SerializableAttribute]
public ref class DataProviderException abstract : public Exception

[<AbstractClass>]
[<SerializableAttribute>]
type DataProviderException =  
    class 
        inherit Exception 
    end

public abstract class DataProviderException extends Exception

DataProviderException 類型會公開下列成員。

建構函式

	名稱	描述
	DataProviderException()	初始化 DataProviderException 類別的新執行個體。
	DataProviderException(String)	指定錯誤訊息，初始化 DataProviderException 類別的新執行個體。
	DataProviderException(SerializationInfo, StreamingContext)	使用序列化資料，初始化 DataProviderException 類別的新執行個體。
	DataProviderException(String, Exception)	DataProviderException 初始化類別的新執行個體，並指定一個錯誤訊息和參考造成這個例外狀況原因的內部例外狀況。

回頁首

屬性

	名稱	描述
	Data	取得提供例外狀況之其他使用者定義相關資訊的索引鍵/值組集合。 (繼承自 Exception)。
	HelpLink	取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承自 Exception)。
	HResult	取得或設定 HRESULT，它是指派給特定例外狀況的編碼數值。 (繼承自 Exception)。
	InnerException	取得造成目前例外狀況的 Exception 執行個體。 (繼承自 Exception)。
	Message	取得描述目前例外狀況的訊息。 (繼承自 Exception)。
	Source	取得或設定造成錯誤的應用程式或物件的名稱。 (繼承自 Exception)。
	StackTrace	取得呼叫堆疊上即時運算框架的字串表示。 (繼承自 Exception)。
	TargetSite	取得擲回目前例外狀況的方法。 (繼承自 Exception)。

回頁首

方法

	名稱	描述
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	在記憶體回收開始前，允許物件嘗試釋放資源，並執行其他清除作業。 (繼承自 Object)。
	GetBaseException	在衍生類別中覆寫時，傳回一或多個後續的例外狀況的根本原因 Exception。 (繼承自 Exception)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetObjectData	安全性關鍵。 在衍生類別中覆寫時，使用例外狀況的資訊設定 SerializationInfo。 (繼承自 Exception)。
	GetType	取得目前執行個體的執行階段類型。 (繼承自 Exception)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	ToString	建立並傳回目前例外狀況的字串表示。 (繼承自 Exception)。

回頁首

事件

	名稱	描述
	SerializeObjectState	當例外狀況序列化，以建立包含例外狀況相關序列化資料的例外狀況狀態物件時，就會發生此事件。 (繼承自 Exception)。

回頁首

備註

這個例外狀況，就會擲回 DDEX 由 DDEX 提供者處理常式處理的提供者登錄的初始驗證成功時，不過，在進一步檢查清單中找到為 false。 它也會擲回，而核心支援實體 (例如 IVsDataConnectionProperties 連接時，會將它視為基本的 DDEX 提供者實作，如果找不到或不支援。

當擲回此例外狀況時，泛型錯誤訊息顯示給使用者，表示 DDEX 提供者的問題，而且提供者寫入器應該聯繫。 完整錯誤描述登入 Windows 事件記錄檔。

不預期會用戶端或提供者會攔截並處理這個例外狀況，，除非已在最後重新擲回或在訊息方塊中顯示之錯誤訊息的 catch 一般區塊內。

DataProviderException 使用 HRESULT E_UNEXPECTED，其值 0x8000FFFF。

範例

您可以使用 IVsDataProvider 物件，下列程式碼示範嘗試建立的 DDEX 支援實體。 如果支援實體無法建立，則程式碼會顯示包含錯誤的訊息方塊。

using System;
using System.Windows.Forms;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DdexExample
{
    public static IVsDataConnectionProperties CreateConnectionProperties(
        IVsDataProvider provider)
    {
        IVsDataConnectionProperties connProperties = null;
        try
        {
            connProperties = provider.CreateObject<IVsDataConnectionProperties>();
        }
        catch (DataProviderException e)
        {
            MessageBox.Show(e.Message);
        }
        return connProperties;
    }
}

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data.Core 命名空間