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	当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根源。 （继承自 Exception。）
	GetHashCode	用作特定类型的哈希函数。 （继承自 Object。）
	GetObjectData	当在派生类中重写时，用关于异常的信息设置 SerializationInfo。 （继承自 Exception。）
	GetType	获取当前实例的运行时类型。 （继承自 Exception。）
	MemberwiseClone	创建当前 Object 的浅表副本。 （继承自 Object。）
	ToString	创建并返回当前异常的字符串表示形式。 （继承自 Exception。）

页首

备注

此，将引发异常。DDEX由DDEX提供程序管理器服务的提供程序注册的初始验证成功时，但是，在进一步试中发现不正确。它也会引发异常，在核心支持实体例如 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;
    }
}

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.Data.Core 命名空间