IVsDataSourceSpecializer.GetAssembly, méthode

  • Article

Résout une chaîne spécifique au fournisseur d'assembly en sa représentation correspondante d' Assembly , pour une source de données du détail DDEX.

Espace de noms :  Microsoft.VisualStudio.Data.Core
Assembly :  Microsoft.VisualStudio.Data.Core (dans Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Déclaration
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

Paramètres

  • source
    Type : Guid

    Un identificateur de source de données de DDEX.

  • assemblyString
    Type : String

    Une chaîne spécifique au fournisseur d'assembly.

Valeur de retour

Type : Assembly
Un objet d' Assembly représentant l'assembly a résolu de la chaîne spécifiée d'assembly, pour la source de données spécifiée de DDEX, si détecté ; sinon, nullune référence null (Nothing en Visual Basic).

Exceptions

Exception Condition
ArgumentNullException

Le paramètre assemblyString est nullune référence null (Nothing en Visual Basic).

Notes

Un fournisseur applique cette méthode lorsqu'il existe des noms de l'assembly spécifiés sous forme de chaînes dans les formats tels qu'un fichier XML de prise en charge de données, et ces noms d'assemblys ne peuvent pas être résolus automatiquement (ou sont résolus correctement) par la méthode d' Load du CLR. Une utilisation de cette méthode est de développer une déclaration incomplète d'assembly. (Par exemple, si la chaîne est « MyAssembly » il peut devenir développé à « MyAssembly, Version= 2.0.0.0, Culture=neutral, PublicKeyToken=1234567890ABCDEF » avant que le CLR le résoudre.)

Cette méthode est fournie pour raccourcir la spécification d'un fournisseur du type noms, qui peut aider à éviter la duplication d'un assembly utilisé dans toute la base de code. La spécialisation de source de données active fournies par cette méthode davantage l'utilisation de chaînes courantes d'assembly pour référencer les assemblys potentiellement différents lorsque différentes sources de données de DDEX sont ciblées par le client.

Exemples

Le code suivant montre comment appliquer cette méthode pour retourner des assemblys selon la source de données de DDEX. L'exemple hérite de la classe d' DataSourceSpecializer d'infrastructure, qui fournit une implémentation par défaut des autres méthodes sur l'interface.

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

Sécurité .NET Framework

Voir aussi

Référence

IVsDataSourceSpecializer Interface

Microsoft.VisualStudio.Data.Core, espace de noms