IVsDataProvider-Schnittstelle

Stellt einen DDEX-Anbieter bereit.

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

Syntax

'Declaration
Public Interface IVsDataProvider

public interface IVsDataProvider

public interface class IVsDataProvider

type IVsDataProvider =  interface end

public interface IVsDataProvider

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

Eigenschaften

	Name	Beschreibung
	Description	Ruft eine Beschreibung des DDEX-Anbieters ab.
	DisplayName	Ruft den Anzeigenamen des DDEX-Anbieters ab.
	Guid	Ruft den eindeutigen Bezeichner des DDEX-Anbieters ab.
	Name	Ruft den programmgesteuerten Namen des DDEX-Anbieters ab.
	ShortDisplayName	Ruft einen kurzen Anzeigenamen des DDEX-Anbieters ab.
	Technology	Ruft den eindeutigen Bezeichner der zugrunde liegenden Technologie ab, die vom DDEX-Anbieter gespeichert wird und zielbezogen ist.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CreateObject(Type)	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität, die vom DDEX-Anbieter implementiert wird.
	CreateObject(Guid, Type)	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle, die vom DDEX-Anbieter implementiert wird.
	CreateObject<TObject>()	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität, die vom DDEX-Anbieter implementiert wird.
	CreateObject<TObject>(Guid)	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle, die vom DDEX-Anbieter implementiert wird.
	CreateObject<TSite>(Guid, Type, TSite)	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle, die vom DDEX-Anbieter implementiert wird, positioniert mit dem angegebenen Site-Objekt.
	CreateObject<TObject, TSite>(Guid, TSite)	Erstellt eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle, die vom DDEX-Anbieter implementiert wird, positioniert mit dem angegebenen Site-Objekt.
	DeriveSource	Berechnet eine DDEX-Datenquelle, die von den DDEX-Anbieter unterstützt wird, Informationen über eine Zieldatenquelle angegeben.
	GetAssembly(String)	Löst eine anbieterspezifische Assemblyzeichenfolge an dessen entsprechende Assembly Darstellung auf.
	GetAssembly(Guid, String)	Löst eine anbieterspezifische Assemblyzeichenfolge an dessen entsprechende Assembly Darstellung, für eine Datenquelle des spezifischen DDEX auf.
	GetMainAssembly	Ruft die Hauptassembly des Anbieters ab.
	GetProperty	Ruft eine registrierte Eigenschaft des DDEX-Anbieters ab.
	GetString	Ruft eine lokalisierte Zeichenfolge vom DDEX-Anbieter ab.
	GetType(String)	Löst einen anbieterspezifischen Typnamen an dessen entsprechende Type Darstellung auf.
	GetType(Guid, String)	Löst einen anbieterspezifischen Typnamen an dessen entsprechende Type Darstellung, für eine Datenquelle des spezifischen DDEX auf.
	GetUnsupportedReason(CommandID, Object)	Ruft eine lokalisierte Zeichenfolge ab, die erläutern, warum ein Vorgang wird nicht unterstützt.
	GetUnsupportedReason(Guid, CommandID, Object)	Ruft eine lokalisierte Zeichenfolge ab, die erläutern, warum ein Vorgang nicht für die angegebene DDEX-Datenquelle unterstützt wird.
	IsOperationSupported(CommandID, Object)	Bestimmt, ob ein Einzelgeschäft vom Anbieter in die aktuelle Umgebung unterstützt wird.
	IsOperationSupported(Guid, CommandID, Object)	Bestimmt, ob ein Einzelgeschäft vom Anbieter in die aktuelle Umgebung unterstützt wird, für die angegebene DDEX-Datenquelle.
	SupportsObject(Type)	Bestimmt, ob ein DDEX-Anbieter den angegebenen Typ der DDEX-Unterstützungsentität unterstützt.
	SupportsObject(Guid, Type)	Bestimmt, ob ein DDEX-Anbieter den angegebenen Typ der DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle unterstützt.
	TryCreateObject(Type)	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität zu erstellen, die vom DDEX-Anbieter implementiert wird.
	TryCreateObject(Guid, Type)	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle zu erstellen, die vom DDEX-Anbieter implementiert wird.
	TryCreateObject<TObject>()	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität zu erstellen, die vom DDEX-Anbieter implementiert wird.
	TryCreateObject<TObject>(Guid)	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle zu erstellen, die vom DDEX-Anbieter implementiert wird.
	TryCreateObject<TSite>(Guid, Type, TSite)	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle zu erstellen, die vom DDEX-Anbieter implementiert wird, positioniert mit dem angegebenen Site-Objekt.
	TryCreateObject<TObject, TSite>(Guid, TSite)	Versucht, eine Instanz der angegebenen DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle zu erstellen, die vom DDEX-Anbieter implementiert wird, positioniert mit dem angegebenen Site-Objekt.

Zum Seitenanfang

Hinweise

Ein DDEX-Anbieterobjekt stellt Informationen zu einem Anbieter, der in der Visual Studio-Umgebung registriert wird. Sie ist der Einstiegspunkt, damit DDEX-Clients mit einem DDEX-Anbieter interagieren. Jeder Anbieter weist eine eindeutige GUID, die es von allen anderen unterscheidet, sowie eine Vielzahl von Namen und einer Beschreibung. Diese Schnittstelle stellt einen Satz von Eigenschaften, die benutzerdefinierte Eigenschaften des Anbieters definieren, sowie eine Methode, die lokalisierte Zeichenfolgen abruft, wenn sie eine Ressourcen-ID-Zeichenfolge angegeben ist, die anbieterabhängig ist. Sie stellt auch eine Methode zum Bestimmen einer DDEX-Datenquelle, wenn sie eine Verbindungszeichenfolge angegeben ist, die Informationen zu der Zieldatenquelle enthält. Sie stellt Methoden zum Identifizieren und das Erstellen von DDEX-Unterstützungsentitäten, die vom Anbieter implementiert werden. Schließlich stellt sie Auflösungsmethoden für verwaltete Typen und Assemblys, die vom Anbieter verwendet werden.

Ein DDEX-Anbieterobjekt kann abgerufen werden, indem der IVsDataProviderManager Dienst verwendet.

Beispiele

Der folgende Code zeigt, z ein Client einen Anbieter für bestimmte DDEX abrufen und seinem Anzeigenamen und Beschreibung ausgeben kann, und erstellt anschließend eine der Entitäten des standardmäßigen DDEX unterstützen

using System;
using System.Diagnostics;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DDEX_IVsDataProviderExample1
{
    public static void UseDataProvider(
        IServiceProvider serviceProvider,
        Guid providerGuid)
    {
        IVsDataProviderManager providerManager =
            serviceProvider.GetService(typeof(IVsDataProviderManager))
                as IVsDataProviderManager;
        IVsDataProvider provider = providerManager.Providers[providerGuid];
        Trace.WriteLine(provider.DisplayName);
        Trace.WriteLine(provider.Description);
        IVsDataConnectionProperties connectionProperties =
            provider.CreateObject<IVsDataConnectionProperties>();
        connectionProperties.Parse("Test connection string");
    }
}

Siehe auch

Referenz

Microsoft.VisualStudio.Data.Core-Namespace