DataConnectionSupport-Klasse

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

Vererbungshierarchie

Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.ServiceProviderWithSite
      Microsoft.VisualStudio.Data.DataConnectionSupport
        Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetConnectionSupport

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

Syntax

'Declaration
Public MustInherit Class DataConnectionSupport _
    Inherits ServiceProviderWithSite _
    Implements IDisposable

public abstract class DataConnectionSupport : ServiceProviderWithSite, 
    IDisposable

public ref class DataConnectionSupport abstract : public ServiceProviderWithSite, 
    IDisposable

[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit ServiceProviderWithSite 
        interface IDisposable 
    end

public abstract class DataConnectionSupport extends ServiceProviderWithSite implements IDisposable

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

Konstruktoren

	Name	Beschreibung
	DataConnectionSupport	Klassenkonstruktor.Instanziiert eine Instanz der Klasse nonparameterized DataConnectionSupport.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	ConnectionString	Ruft ab oder legt eine Zeichenfolgendarstellung von Informationen benötigt, eine bestimmte Datenquellenverbindung herzustellen fest.
	ConnectionTimeout	Ruft ab oder vor dem Beenden des Versuchs und dem Generieren eines Timeoutfehler legt die Zeit, in Sekunden, von Wait, eine Verbindung herzustellen fest.
	ProviderObject	Ruft das zugrunde liegende Datenanbieterobjekt für die angegebene Verbindung ab.
	ServiceTypes	Ruft eine Liste der Diensttypen ab, die verwendet werden, um den nicht verwalteten QueryService-Methodenaufruf zu konvertieren, in dem ein Dienst GUID, in einen verwalteten IServiceProvider.GetService-Methodenaufruf angegeben wird, in dem ein verwalteter Typ angegeben wird. (Von ServiceProvider geerbt.)
	Site	Ruft ab oder legt diese Siteobjektinstanz fest. (Von ServiceProviderWithSite geerbt.)
	State	Ruft den Zustand der Datenverbindung ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Close	Schließt die angegebene Verbindung.
	Dispose()	Führt Aufgaben aus, die mit dem Freigeben oder dem Zurücksetzen von Ressourcen zusammenhängen.
	Dispose(Boolean)	Führt Aufgaben aus, die mit dem Freigeben oder dem Zurücksetzen von Ressourcen zusammenhängen.
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Schließt die Verbindung ab. (Ü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.)
	GetServiceImpl(Type)	Ermöglicht es, zu erhalten Implementierungsdienstleistungen. (Überschreibt ServiceProvider.GetServiceImpl(Type).)
	GetServiceImpl(Guid)	Stellt die Implementierung für das Abrufen eines Diensts mit einem bestimmten GUID. (Von ServiceProvider geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	Initialize	Initialisiert die angegebene Verbindung, optional von einem Anbieterobjekt der vorhandenen Daten.
	MemberwiseClone	Erstellt eine flache Kopie vom aktuellen Object. (Von Object geerbt.)
	OnSiteChanged	Löst das SiteChanged-Ereignis aus. (Von ServiceProviderWithSite geerbt.)
	Open	Öffnet die angegebene Verbindung.
	RaiseMessageReceived	Löst das Ereignis MessageReceived auf der einschließenden DataConnection-Instanz aus.
	RaiseStateChanged	Löst das Zustand Changed-Ereignis auf der einschließenden DataConnection-Instanz aus.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	SiteChanged	Ereignis ausgelöst, wenn die Site-Eigenschaft geändert wurde. (Von ServiceProviderWithSite geerbt.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IObjectWithSite.GetSite	Ruft die letzte Website ab, die mit der IObjectWithSite.SetSite methode festgelegt ist.Wenn keine bekannte Site auftreten, wird eine Ausnahme ausgelöst. (Von ServiceProviderWithSite geerbt.)
	IServiceProvider.QueryService	Führt als Factory für Dienste ausgeführt, die durch eine Implementierung von IServiceProvider verfügbar gemacht werden. (Von ServiceProvider geerbt.)
	IObjectWithSite.SetSite	Stellt IUnknown Zeiger der Website zu einem bestimmten Objekt bereit. (Von ServiceProviderWithSite geerbt.)

Zum Seitenanfang

Hinweise

Die Klasse stellt die DataConnectionSupport Datenanbieterimplementierung dar, um eine Datenverbindung zu unterstützen. Die DDEX-Architektur implementiert die DataConnection-Klasse, indem sie in bestimmte DataConnectionSupport des Anbieters eine Implementierung aufruft.

Die Eigenschaften und Methoden in dieser Klasse stellen die grundlegende Funktionalität, die dem Datenanbieter ermöglicht, die Datenquelle sein und führen diese Aufgaben aus, die Start- und Schließen von Verbindungen und Abrufen von Verbindungsstatus. Ein Datenanbieter kann mehr Fachdienste auch verfügbar machen, indem er die GetServiceImpl-Methode überschreibt. Diese verbindungsbezogenen Dienste werden nach zusammengefasst:

• DataViewSupport: Stellt eine Methode für das Abrufen von XML bereit, das bestimmte Ansichten der Datenquelle aus den beschreibt Visual Studio im Server-Explorer angezeigt werden, Datenobjekte.

• DataObjectSupport: Stellt eine Methode für das Abrufen von XML bereit, welche Typen von den Datenobjekten beschrieben werden, die für die Datenquelle und die Aktionen, die unterstützt werden, auf ihnen ausgeführt werden können.

• DataObjectIdentifierResolver: Stellt eine Methode zum Auflösen von Datenobjektbezeichnern bereit.

• DataObjectIdentifierConverter: Stellt Methoden zum Konvertieren zwischen Zeichenfolge und Arraydarstellungen von Datenobjektbezeichnern bereit.

• DataObjectItemComparer: Stellt Methoden zum Vergleichen von Datenobjektbezeichnerteilen und -Eigenschaftswerten bereit.

• DataCommand: Stellt die Möglichkeit, verschiedene Typen von Befehlen zu berechnen und auszuführen.

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

• DataTransaction: Stellt die Möglichkeit, Transaktionen zu starten, Commit und zurückzusetzen.

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

• DataSourceInformation: Stellt einen Satz von wohl geformten Name-Wert-Paare bereit, die die Datenquelle beschreiben.

Diese Klasse implementiert die Schnittstelle IObjectWithSite, die DDEX ermöglicht, DataConnectionSupport Implementierung eines Datenanbieters mit dem DataConnection-Objekt zu positionieren, das in der aufrufenden ist. Dies stellt die Implementierung mit Kontext sowie durch eine Methode zum Abrufen von Visual Studio Dienste.

Eine abgeleitete Klasse sollte die verschiedenen abstrakten Eigenschaften und Methoden implementieren, um die Verbindung zu unterstützen. Eine abgeleitete Klasse sollte die GetServiceImpl geschützte Methode auch überschreiben, um die Verbindungsdienstleistungen bereitzustellen. Wenn eine Zustandänderung oder ein Meldung-empfangenes Ereignis auftritt, eine von abgeleitete Klasse, nach Möglichkeit das geschützte RaiseStateChanged und die RaiseMessageReceived-Methoden aufrufen, die die Basisklasse dann an das positionierte DataConnection-Objekt weiterleitet.

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

ServiceProviderWithSite

IDisposable