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, наконец re- штрихи или отображается сообщение об ошибке в окне сообщения.

DataProviderException использует HRESULT E_UNEXPECTED, имеющий значение 0x8000FFFF.

Примеры

Следующий код демонстрирует попытка создание сущности поддержки DDEX с помощью объекта IVsDataProvider.Если не удается создать сущность поддержки, то код отображает окно сообщения, содержащее ошибку.

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 (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.VisualStudio.Data.Core - пространство имен