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	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	既定のハッシュ関数として機能します。 (Object から継承されます。)
	GetObjectData	セキュリティ クリティカル。 派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (Exception から継承されます。)
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	MemberwiseClone	Object の簡易コピーを作成します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

このページのトップへ

イベント

	名前	説明
	SerializeObjectState	例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。 (Exception から継承されます。)

このページのトップへ

解説

この例外は DDEX プロバイダー マネージャー サービスによる DDEX プロバイダーの登録の最初の検証が成功したが、それ以上の質問に誤る検出するとスローされます。 また、DDEX プロバイダーの実装に基本的考慮する IVsDataConnectionProperties などのコア サポートのエンティティがインターフェイスすると、ありませんが、はサポートされませんがスローされます。

この例外がスローされると、一般的なエラー メッセージが DDEX プロバイダーに問題があることと、プロバイダー ライターに接続する必要があることを示すユーザーに示します。 詳細なエラーの説明は Windows イベント ログに記録されます。

最終的に再スローしますがメッセージ ボックスにエラー メッセージを表示する catch の一般的なブロック内にあるクライアントまたはプロバイダーがこの例外をキャッチして処理と予想されません。

DataProviderException は HRESULT 値 0x8000FFFF を持つ E_UNEXPECTED を使用します。

例

次のコードは 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;
    }
}

スレッド セーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

参照

関連項目

Microsoft.VisualStudio.Data.Core 名前空間