IVsDataSourceSpecializer.DeriveSource (Método)
Deriva un origen de datos de DDEX, cuando es posible, una cadena proveedor- específica de la conexión de datos de DDEX.
Espacio de nombres: Microsoft.VisualStudio.Data.Core
Ensamblado: Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)
Sintaxis
'Declaración
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
Una cadena proveedor- específica de la conexión de datos de DDEX que define un origen de datos de destino.
Valor devuelto
Tipo: System.Guid
Un identificador válido, registrado de origen de datos de DDEX que se ha determinado para representar el tipo de origen de datos de destino identificado por la cadena de conexión.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | El valor del parámetro connectionString es nullreferencia null (Nothing en Visual Basic). |
Comentarios
Este es el método más importante en la interfaz de IVsDataSourceSpecializer .Permite a los clientes de DDEX para utilizar una cadena de sólo DDEX de proveedor de identificador y de la conexión de datos para determinar si un proveedor ha especializado compatibilidad para el origen de datos de DDEX indicada por la información de la cadena de conexión.Si este método devuelve el GUID no vacío, el cliente cambiará normalmente y llamará a otros métodos de la interfaz, pasando el identificador del origen de datos de DDEX, para recuperar aplicaciones origen- específicas de los datos de entidades admiten.
Ejemplos
El código siguiente se muestra una implementación básica de este método para el proveedor de Microsoft SQL Server DDEX.Este proveedor admite dos orígenes de datos: uno es una base de datos de SQL Server y otra es una base de datos de SQL Server Express que utiliza un archivo de base de datos en el equipo local.Determina que el origen de datos debe ser un archivo de base de datos cuando hay una palabra clave de AttachDBFilename en la cadena de conexión.(Este ejemplo no muestra el enfoque recomendado, que sería analizar correctamente la cadena). El ejemplo hereda de la clase de DataSourceSpecializer de marco, que proporciona una implementación predeterminada de los otros métodos de la interfaz.
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;
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.