Método IVsDataSourceSpecializer.DeriveSource

Artigo
10/26/2012

Derivado uma fonte de dados de DDEX, quando possível, de uma cadeia de conexão específica do provedor de dados de DDEX.

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

Sintaxe

'Declaração
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

Parâmetros

connectionString
Tipo: System.String
Uma cadeia de conexão específica do provedor de dados de DDEX que define uma fonte de dados de destino.

Valor de retorno

Tipo: System.Guid
Um identificador válido, registrado da fonte de dados de DDEX que foi determinado representar o tipo de fonte de dados de destino tenha identificado pela cadeia de conexão.

Exceções

Exceção	Condição
ArgumentNullException	o parâmetro de connectionString é nulluma referência nula (Nothing no Visual Basic).

Comentários

Este método é o mais importante na interface de IVsDataSourceSpecializer .Permite que clientes de DDEX para usar uma cadeia de conexão apenas de DDEX do provedor e identificador de dados para determinar se um provedor especializou suporte para a fonte de dados de DDEX apontada por informações na cadeia de conexão.Se esse método retornar GUID não vazio, o cliente girará normalmente ao redor e chamar outros métodos na interface, passando o identificador da fonte de dados de DDEX, para recuperar implementações fonte de dados específicas de entidades de suporte.

Exemplos

O código a seguir demonstra uma implementação básica de esse método para o provedor Microsoft SQL Server DDEX.Este provedor suporta duas fontes de dados: um é um banco de dados SQL Server e outro é um banco de dados SQL Server Express edition que usa um arquivo de banco de dados no computador local.Determina que a fonte de dados deve ser um arquivo de banco de dados quando há uma palavra-chave de AttachDBFilename na cadeia de conexão.(Este exemplo não mostra a abordagem recomendada, que poderia analisar corretamente a cadeia de caracteres.) O exemplo herda da classe de DataSourceSpecializer estrutura, que fornece uma implementação padrão dos outros métodos da interface.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

IVsDataSourceSpecializer Interface

Namespace Microsoft.VisualStudio.Data.Core

Compartilhar via