IVsDataSourceSpecializer.DeriveSource-Methode

Artikel
05/16/2015

Berechnet eine DDEX-Datenquelle, wenn möglich, einer anbieterspezifischen Datenverbindungszeichenfolge DDEX.

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

Syntax

'Declaration
Function DeriveSource ( _
    connectionString As String _
) As Guid

Guid DeriveSource(
    string connectionString
)

Guid DeriveSource(
    String^ connectionString
)

abstract DeriveSource : 
        connectionString:string -> Guid

function DeriveSource(
    connectionString : String
) : Guid

Parameter

connectionString
Typ: String

Eine anbieterspezifische Datenverbindungszeichenfolge DDEX, die eine Zieldatenquelle definiert.

Rückgabewert

Typ: Guid
Ein gültiger, registrierter DDEX-Datenquellenbezeichner, der bestimmt wurde, um den Typ der Zieldatenquelle darzustellen, identifizierte durch die Verbindungszeichenfolge.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der connectionString-Parameter ist nullein Nullverweis (Nothing in Visual Basic).

Hinweise

Dies ist die wichtigste Methode auf der IVsDataSourceSpecializer-Schnittstelle. Außerdem können DDEX-Clienten, um nur eine DDEX-Anbieterbezeichner- und -Datenverbindungszeichenfolge zu verwenden, um zu bestimmen, ob ein Anbieter Unterstützung für die DDEX-Datenquelle spezialisiert enthält, die nach zu den Informationen in der Verbindungszeichenfolge dargestellt wird. Wenn diese Methode ein nicht leeres GUID zurückgibt, dreht der Client normalerweise herum und ruft andere Methoden der Schnittstelle auf und übergibt den DDEX-Datenquellenbezeichner, um datenquellenspezifische Implementierungen von Stützentitäten abzurufen.

Beispiele

Im folgenden Code wird eine grundlegende Implementierung dieser Methode für den Anbieter Microsoft SQL Server DDEX. Dieser Anbieter unterstützt zwei Datenquellen: Ein Steuerelement ist eine SQL Server-Datenbank und andere ist eine SQL Server Express Edition-Datenbank, die eine Datenbankdatei auf dem lokalen Computer verwendet. Sie bestimmt, dass die Datenquelle eine Datenbankdatei sein soll, wenn es ein AttachDBFilename-Schlüsselwort in der Verbindungszeichenfolge gibt. (In diesem Beispiel wird nicht die empfohlene Vorgehensweise an, die, die Zeichenfolge ordnungsgemäß zu analysieren. wäre) Das Beispiel erbt von der DataSourceSpecializer-Frameworkklasse, die eine Standardimplementierung der anderen Methoden auf der Schnittstelle bereitstellt.

using System;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Framework;

public class MySourceSpecializer3 : DataSourceSpecializer
{
    private static readonly Guid s_sqlServerDataSource =
        new Guid("067EA0D9-BA62-43f7-9106-34930C60C528");
    private static readonly Guid s_sqlServerFileDataSource =
        new Guid("485C80D5-BC85-46db-9E6D-4238A0AD7B6B");

    public override Guid DeriveSource(string connectionString)
    {
        if (connectionString == null)
        {
            throw new ArgumentNullException("connectionString");
        }
        if (connectionString.Contains("AttachDBFilename"))
        {
            return s_sqlServerFileDataSource;
        }
        return s_sqlServerDataSource;
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsDataSourceSpecializer Schnittstelle

Microsoft.VisualStudio.Data.Core-Namespace

Freigeben über