DataProviderException クラス

またはが無効な登録されていないか、またはエンティティのサポートなどの DDEX のプロバイダーで予期しない問題があるときに発生する例外を表します。

継承階層

System.Object
  System.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 から継承されます。)

このページのトップへ

解説

この例外は 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 名前空間

  • Last updated on