DataProviderException – třída

Představuje výjimku, kdy neočekávané potíže s DDEX zprostředkovatele, například chybějící nebo neplatné registrace nebo podpora subjektů.

Hierarchie dědičnosti

System.Object
  System.Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

Obor názvů:  Microsoft.VisualStudio.Data.Core
Sestavení:  Microsoft.VisualStudio.Data.Core (v Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Deklarace
<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

Typ DataProviderException zveřejňuje následující členy.

Konstruktory

	Název	Popis
	DataProviderException()	Vytvoří novou instanci třídy DataProviderException.
	DataProviderException(String)	Inicializuje novou instanci DataProviderException třídy určení chybová zpráva.
	DataProviderException(SerializationInfo, StreamingContext)	Inicializuje novou instanci DataProviderException třídy Serializovaná data.
	DataProviderException(String, Exception)	Inicializuje novou instanci DataProviderException třídy chybovou zprávu a odkaz na vnitřní výjimka, který je příčinou této výjimky.

Nahoru

Vlastnosti

	Název	Popis
	Data	Získá kolekce páry klíč hodnota, obsahují další informace o výjimce uživatelem. (Zděděno z Exception.)
	HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružené k této výjimce. (Zděděno z Exception.)
	HResult	Získá nebo nastaví HRESULT kódované číselná hodnota, která je přiřazena k určité výjimky. (Zděděno z Exception.)
	InnerException	Získá instanci Exception, která způsobila aktuální výjimku. (Zděděno z Exception.)
	Message	Získá zprávu popisující aktuální výjimku. (Zděděno z Exception.)
	Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno z Exception.)
	StackTrace	Řetězcové vyjádření okamžité rámce získá v zásobníku volání. (Zděděno z Exception.)
	TargetSite	Získá metodu, která vyvolala aktuální výjimku. (Zděděno z Exception.)

Nahoru

Metody

	Název	Popis
	Equals	Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.)
	Finalize	Umožňuje objekt při uvolnění prostředků a provádět jiné operace vyčištění před je zažádáno systémem uvolňování paměti. (Zděděno z Object.)
	GetBaseException	V odvozené třídě přepsána, vrátí Exception je příčina jeden nebo více následujících výjimek. (Zděděno z Exception.)
	GetHashCode	Slouží jako funkci hash u určitého typu. (Zděděno z Object.)
	GetObjectData	Při přepsání v odvozené třídě, nastaví SerializationInfo informace o výjimce. (Zděděno z Exception.)
	GetType	Načte aktuální instanci typu runtime. (Zděděno z Exception.)
	MemberwiseClone	Vytvoří kopii aktuálního Object. (Zděděno z Object.)
	ToString	Vytvoří a vrátí řetězec reprezentace aktuální výjimku. (Zděděno z Exception.)

Nahoru

Poznámky

Tato výjimka se vyvolá při prvotního ověření registrace zprostředkovatele DDEX službou Správce DDEX provider je úspěšný, ale na další vyhledával byla vyhodnocena jako chybné.Také to je vyvolána při základní podpory subjektů, jako IVsDataConnectionProperties rozhraní, které jsou považovány za zásadní pro implementaci DDEX provider, nejsou nalezeny nebo podporovány.

Po tato výjimka uživateli DDEX provider je problém a že je třeba kontaktovat zprostředkovatele Zapisovatel zobrazí obecná chybová zpráva.Úplný popis chyby je zaznamenána do protokolu událostí systému Windows.

Očekávat, že klienti nebo poskytovatelů bude zachytit a zpracovat tuto výjimku, pokud je v rámci Obecné catch blok, který se nakonec re-throws nebo v okně se zprávou se zobrazí chybová zpráva.

DataProviderExceptionpoužívá hodnotu HRESULT E_UNEXPECTED, který má hodnotu 0x8000FFFF.

Příklady

Následující kód ukazuje pokus o vytvoření entitu DDEX podporu pomocí IVsDataProvider objektu.Pokud nelze vytvořit entitu podpory, kód se zobrazí okno se zprávou obsahující chybu.

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;
    }
}

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

Viz také

Referenční dokumentace

Microsoft.VisualStudio.Data.Core – obor názvů