DataConnectionSupport-Klasse

Stellt Eigenschaften und Methoden bereit, die Ihnen, direkt mit Verbindungen zu einer Datenquelle zu arbeiten.

Vererbungshierarchie

Object
  Microsoft.VisualStudio.Data.Framework.ServiceProvider
    Microsoft.VisualStudio.Data.Framework.DataSiteableServiceProvider<IVsDataConnection>
      Microsoft.VisualStudio.Data.Framework.DataConnectionSupport
        Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetConnectionSupport

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

Syntax

'Declaration
Public MustInherit Class DataConnectionSupport _
    Inherits DataSiteableServiceProvider(Of IVsDataConnection) _
    Implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public ref class DataConnectionSupport abstract : public DataSiteableServiceProvider<IVsDataConnection^>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit DataSiteableServiceProvider<IVsDataConnection>
        interface IVsDataConnectionSupport 
        interface IServiceProvider 
        interface IDisposable 
        interface IVsDataConnectionEvents 
    end

public abstract class DataConnectionSupport extends DataSiteableServiceProvider<IVsDataConnection> implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

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

Konstruktoren

	Name	Beschreibung
	DataConnectionSupport	Initialisiert eine neue Instanz der DataConnectionSupport-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	ConnectionString	Ruft eine Zeichenfolgendarstellung von Informationen erforderlich, eine angegebene Datenquellenverbindung einzurichten fest.
	ConnectionTimeout	Ruft ab oder legt die Dauer fest, um zu warten, wenn, vor dem Stopp des Versuchs und dem Generieren eines Timeoutfehler eine Verbindung Objekt.
	ParentProvider	Ruft die aktuelle Instanz des übergeordneten Dienstanbieters ab. (Von ServiceProvider geerbt.)
	ProviderObject	Ruft den zugrunde liegenden Datenanbieter ab, der die aktueller Datenverbindung unterstützt.
	ServiceProvider	Ruft den globalen Dienstanbieter Visual Studio ab.
	Site	Ruft ab oder legt die Website fest. (Von DataSiteableServiceProvider<T> geerbt.)
	State	Ruft den Zustand der Datenverbindung ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddService(Type, ServiceCreatorCallback)	Fügt den angegebenen Dienst der internen Auflistung der Dienste hinzu. (Von ServiceProvider geerbt.)
	AddService(Type, Object)	Fügt den angegebenen Dienst der internen Auflistung der Dienste hinzu. (Von ServiceProvider geerbt.)
	AddService(Type, ServiceCreatorCallback, Boolean)	Fügt den angegebenen Dienst der internen Auflistung der Dienste oder dem übergeordneten Dienstcontainer hinzu. (Von ServiceProvider geerbt.)
	AddService(Type, Object, Boolean)	Fügt den angegebenen Dienst der Auflistung von Dienstobjekten oder dem übergeordneten Dienstcontainer hinzu. (Von ServiceProvider geerbt.)
	Close	Schließt die angegebene Verbindung.
	CreateService	Erstellt ein neues Dienstobjekt und gibt den Schnittstellendiensttyp an.
	Dispose()	Gibt alle Ressourcen freigeben, die von der Datenverbindung angehalten werden.
	Dispose(Boolean)	Gibt alle Ressourcen freigeben, die von der Datenverbindung angehalten werden.
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt alle Ressourcen freigeben, die von der Datenverbindung angehalten werden, wenn das Datenverbindungsunterstützungsobjekt zerstört wird. (Überschreibt Object.Finalize.)
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetService(Guid)	Ruft einen Dienst mit einem angegebenen Dienst GUID ab. (Von ServiceProvider geerbt.)
	GetService(Type)	Ruft einen Dienst des angegebenen Typs ab. (Von ServiceProvider geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	Initialize	Initialisiert die angegebene Verbindung, optional vor einem Anbieterobjekt der vorhandenen Daten.
	MemberwiseClone	Erstellt eine flache Kopie vom aktuellen Object. (Von Object geerbt.)
	OnMessageReceived	Behandelt das MessageReceived-Ereignis.
	OnSiteChanged	Löst das SiteChanged-Ereignis aus. (Von DataSiteableServiceProvider<T> geerbt.)
	OnStateChanged	Behandelt das StateChanged-Ereignis.
	Open	Öffnet die angegebene Datenverbindung.
	RemoveService(Type)	Entfernt den angegebenen Dienst aus der internen Dienstauflistung (Von ServiceProvider geerbt.)
	RemoveService(Type, Boolean)	Entfernt den angegebenen Dienst aus der internen Dienstauflistung oder vom übergeordneten Dienstcontainer. (Von ServiceProvider geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	MessageReceived	Tritt auf, wenn eine Meldung aus der Datenquelle empfangen wird.
	SiteChanged	Tritt auf, wenn die Site geändert hat. (Von DataSiteableServiceProvider<T> geerbt.)
	StateChanged	Tritt auf, wenn der Zustand der Datenverbindung geändert hat.

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IServiceProvider.QueryService	Führt als Factory für Dienste ausgeführt, die durch eine Implementierung von IServiceProvider verfügbar gemacht werden. (Von ServiceProvider geerbt.)

Zum Seitenanfang

Hinweise

Die DataConnectionSupport-Klasse stellt die Datenanbieterimplementierung dar, die eine Datenverbindung zu unterstützen.

Die Eigenschaften und Methoden der Klasse stellen die grundlegende Funktionalität der Datenanbieter, die ermöglicht, die Datenquelle sein und übergeben diese Aufgaben aus, die Start- und schließt Verbindungen und Abrufen von Verbindungszustand. Ein Datenanbieter kann Fachdienste auch verfügbar machen, indem er die CreateService-Methode überschreibt. Die aktuellen verbindungsbezogenen Dienste können zusammengefasst werden, wie folgt:

• IVsDataObjectSupport: Stellt eine Methode für das Abrufen von XML zur Verfügung, welche Typen von den Datenobjekten beschrieben, die von der Datenquelle und Aktionen, die unterstützt wurden, auf sie ausgeführt werden können.

• IVsDataObjectIdentifierResolver: Enthält eine Methode zum Auflösen von Datenobjektbezeichnern bereit.

• IVsDataObjectIdentifierConverter: Stellt Methoden für die Konvertierung zwischen Zeichenfolge und Arraydarstellungen von Datenobjektbezeichnern bereit.

• IVsDataObjectMemberComparer: Stellt Methoden für das Vergleichen von Datenobjektbezeichnerteilen und -Eigenschaftswerten bereit.

• IVsDataCommand: Bietet die Möglichkeit bereit, verschiedenen Befehlen zu berechnen und auszuführen.

• IVsDataAsyncCommand: Ermöglicht das Ausführen von Datenbefehlen in einer asynchronen Weise.

• IVsDataTransaction: Bietet die Möglichkeit bereit, Transaktionen zu beginnen, Commit und zurückzusetzen.

• IVsDataSourceVersionComparer: Stellt eine Methode für das Vergleichen von zwei datenquellenspezifischen Versionszeichenfolgen bereit.

• IVsDataSourceInformation: Stellt einen Satz genau definierter Name-Wert-Paare bereit, die die Datenquelle beschreiben.

• IVsDataMappedObjectConverter: Ermöglicht einen benutzerdefinierten Mapper von Metadaten in datenquellenspezifischen bekannte Konzepte für einen generischen Designer beginnen.

• IVsDataObjectSelector: Aktiviert das Abrufen von datenquellenspezifischen Metadaten über die Objekte, die in der Datenobjektunterstützungsxml-datei definiert werden.

• IDSRefBuilder: Bietet die Möglichkeit bereit, Datenquellen-Bezugs- (DSRef)- ein Objekt zu erstellen, das mindestens Datenobjekte identifiziert.

Diese Klasse implementiert die IVsDataSiteableObject<T>-Schnittstelle, die DDEX ermöglicht, DataConnectionSupport Implementierung eines Datenanbieters mit IVsDataConnection-Objekt zu positionieren, das sie in Aufrufen ist. Dadurch verfügen die Implementierung mit Kontext, sowie eine Methode zum Abrufen von Visual Studio Dienste.

Hinweise zur Vererbung

Eine abgeleitete Klasse darf die verschiedenen abstrakten Eigenschaften und Methoden implementieren, um die Verbindung zu unterstützen. Eine abgeleitete Klasse darf die geschützte CreateService-Methode auch überschreiben, um die Implementierung der Verbindungsdienstleistungen bereitzustellen. Wenn eine Zustandänderung oder ein Meldung-empfangenes Ereignis auftritt, sollte eine abgeleitete Klasse, wenn möglich, das geschützte OnStateChanged und die OnMessageReceived-Methoden aufzurufen.

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.Framework-Namespace