IVsDataSourceSpecializer.GetAssembly (Método)

Resuelve una cadena proveedor- específica del ensamblado en su representación correspondiente de Assembly , para un origen de datos específico de DDEX.

Espacio de nombres:  Microsoft.VisualStudio.Data.Core
Ensamblado:  Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)

Sintaxis

'Declaración
Function GetAssembly ( _
    source As Guid, _
    assemblyString As String _
) As Assembly

Assembly GetAssembly(
    Guid source,
    string assemblyString
)

Assembly^ GetAssembly(
    Guid source, 
    String^ assemblyString
)

abstract GetAssembly : 
        source:Guid * 
        assemblyString:string -> Assembly

function GetAssembly(
    source : Guid, 
    assemblyString : String
) : Assembly

Parámetros

• source
  Tipo: Guid

  Un identificador de origen de datos de DDEX.

• assemblyString
  Tipo: String

  Una cadena proveedor- específica del ensamblado.

Valor devuelto

Tipo: Assembly
Un objeto de Assembly que representa el ensamblado resuelto de la cadena especificada del ensamblado, para el origen de datos especificado de DDEX, si se encuentra; si no, nullreferencia null (Nothing en Visual Basic).

Excepciones

Excepción	Condición
ArgumentNullException	El valor del parámetro assemblyString es nullreferencia null (Nothing en Visual Basic).

Comentarios

Un proveedor implementa este método cuando hay nombres de ensamblado especificados como cadenas en formatos como un archivo XML de la compatibilidad de los datos, y estos nombres de ensamblado no pueden resolverlo automáticamente (o ser resuelto incorrectamente) por el método de Load de CLR. Un uso de este método sería expandir una declaración incompleta del ensamblado. (Por ejemplo, si la cadena es “MyAssembly” puede obtener expandido a “MyAssembly, Version= 2.0.0.0, Culture=neutral, PublicKeyToken=1234567890ABCDEF” antes de que CLR lo resuelva.)

Este método se proporciona para acortar la especificación de un proveedor de nombres de tipo, que pueden ayudar a reducir la duplicación de un ensamblado de uso general en la base de código. La especialización de origen de datos proporcionado por este método aún más permisos mediante cadenas comunes de ensamblado para hacer referencia a ensamblados potencialmente diferentes cuando los orígenes de datos diferentes de DDEX están dirigidos por el cliente.

Ejemplos

El código siguiente muestra cómo implementar este método para devolver varios ensamblados según el origen de datos de DDEX. 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 System.Reflection;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Framework;

public class MySourceSpecializer4 : DataSourceSpecializer
{
    private static readonly Guid s_dataSource1 =
        new Guid("EB5246D3-277C-4277-910F-111CB9EAD253");
    private static readonly Guid s_dataSource2 =
        new Guid("1EC8B196-7155-4d5a-BBDC-0CC47D631E52");

    public override Assembly GetAssembly(Guid source, string assemblyString)
    {
        if (source == s_dataSource1)
        {
            return Assembly.Load("AssemblyForDataSource1");
        }
        else if (source == s_dataSource2)
        {
            return Assembly.Load("AssemblyForDataSource2");
        }
        else
        {
            return base.GetAssembly(source, assemblyString);
        }
    }
}

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.

Vea también

Referencia

IVsDataSourceSpecializer Interfaz

Microsoft.VisualStudio.Data.Core (Espacio de nombres)