<qualifyAssembly> , element

  • Artykuł

Określa pełną nazwę zestawu, który powinien być ładowany dynamicznie po użyciu częściowej nazwy.

<Konfiguracji>
  <Środowiska wykonawczego>
    <Assemblybinding>
      <qualifyAssembly>

Składnia

      <qualifyAssembly partialName=  
      "PartialAssemblyName"  
                 fullName="FullAssemblyName"/>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut Opis
partialName Atrybut wymagany.

Określa częściową nazwę zestawu, która pojawia się w kodzie.
fullName Atrybut wymagany.

Określa pełną nazwę zestawu wyświetlaną w globalnej pamięci podręcznej zestawów.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element Opis
assemblyBinding Zawiera informacje o przekierowaniu wersji zestawu i lokalizacji zestawów.
configuration Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
runtime Zawiera informacje dotyczące powiązania zestawu oraz wyrzucania elementów bezużytecznych.

Uwagi

Assembly.Load Wywołanie metody przy użyciu nazw zestawów częściowych powoduje, że środowisko uruchomieniowe języka wspólnego wyszukuje zestaw tylko w katalogu podstawowym aplikacji. <Użyj elementu qualifyAssembly> w pliku konfiguracji aplikacji, aby udostępnić pełne informacje o zestawie (nazwę, wersję, token klucza publicznego i kulturę) oraz spowodować wyszukiwanie zestawu w globalnej pamięci podręcznej zestawów przez środowisko uruchomieniowe języka wspólnego.

Atrybut fullName musi zawierać cztery pola tożsamości zestawu: nazwa, wersja, token klucza publicznego i kultura. Atrybut partialName musi częściowo odwoływać się do zestawu. Musisz określić co najmniej nazwę tekstową zestawu (najczęściej używany przypadek), ale można również uwzględnić wersję, token klucza publicznego lub kulturę (lub dowolną kombinację czterech, ale nie wszystkie cztery). Nazwa partialName musi być zgodna z nazwą określoną w wywołaniu. Na przykład nie można określić "math" jako atrybut partialName w pliku konfiguracji i wywołać Assembly.Load("math, Version=3.3.3.3") w kodzie.

Przykład

Poniższy przykład logicznie zamienia wywołanie Assembly.Load("math") w .Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral")

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <qualifyAssembly partialName="math"
                         fullName=  
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Zobacz też