DataProviderException-Klasse

Stellt die Ausnahme dar, die auftritt, wenn ein unerwartetes Problem mit einem DDEX-Anbieter, wie fehlende oder ungültigen Registrierungs- oder Stützentitäten gibt.

Vererbungshierarchie

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

Namespace:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Syntax

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

Der DataProviderException-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DataProviderException()	Initialisiert eine neue Instanz der DataProviderException-Klasse.
	DataProviderException(String)	Initialisiert eine neue Instanz der DataProviderException-Klasse, wobei eine Fehlermeldung angegeben wird.
	DataProviderException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der DataProviderException-Klasse mit serialisierten Daten.
	DataProviderException(String, Exception)	Initialisiert eine neue Instanz der Klasse DataProviderException und gibt eine Fehlermeldung und einen Verweis auf die inneren Ausnahme an, die die Ursache für diese Ausnahme ist.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen. (Von Exception geerbt.)
	HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Von Exception geerbt.)
	HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Von Exception geerbt.)
	InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Von Exception geerbt.)
	Message	Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt. (Von Exception geerbt.)
	Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Von Exception geerbt.)
	StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Von Exception geerbt.)
	TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Von Exception geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetBaseException	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist. (Von Exception geerbt.)
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetObjectData	Sicherheitsrelevant. Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest. (Von Exception geerbt.)
	GetType	Ruft den Laufzeittyp der aktuellen Instanz ab. (Von Exception geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie vom aktuellen Object. (Von Object geerbt.)
	ToString	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Von Exception geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt zu erstellen, das serialisierte Daten für die Ausnahme enthält. (Von Exception geerbt.)

Zum Seitenanfang

Hinweise

Diese Ausnahme wird ausgelöst, wenn der ursprüngliche Überprüfung DDEX-Anbieterregistrierung durch den DDEX-Anbieter-Managerdienst erfolgreich ist, aber auf weiter Befragung wird sie ermittelt, um beschädigt. Sie wird auch, wenn Kernstützentitäten wie IVsDataConnectionProperties herstellen, die als Basic zu einer DDEX-Anbieterimplementierung gelten, wird nicht gefunden oder unterstützt ausgelöst.

Wenn diese Ausnahme ausgelöst wird, wird eine generische Fehlermeldung dem Benutzer angezeigt, dass ein Problem im DDEX-Anbieter ist und dass mit dem Anbieterwriter Kontakt hergestellt werden soll. Der vollständigen Fehlerbeschreibung wird das Windows-Ereignisprotokoll protokolliert.

Es wird nicht erwartet, dass Clients oder Anbieter diese Ausnahme abfangen und behandeln, es sei denn, sie innerhalb eines Blocks allgemeinen catch ist, der schließlich die Fehlermeldung in einem Meldungsfeld erneut auslöst oder anzeigt.

DataProviderException verwendet HRESULT E_UNEXPECTED, das den Wert 0x8000FFFF verfügt.

Beispiele

Im folgenden Code wird die versuchte Erstellung einer DDEX-Stützentität, indem er ein IVsDataProvider-Objekt verwendet. Wenn die Stützentität nicht erstellt werden kann, zeigt der Code ein Meldungsfeld an, das einen Fehler enthält.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.VisualStudio.Data.Core-Namespace