Správa verzí sestavení

Celá správa verzí sestavení, která používá modul CLR (Common Language Runtime) se provádí na úrovni sestavení. Konkrétní verze sestavení a verze závislých sestavení jsou zaznamenány v manifestu sestavení. Výchozí zásadou správy verzí pro modul runtime je to, že aplikace běží pouze s verzemi, se kterými byly vytvořeny a testovány, ledaže by byla přepsána explicitními zásadami správy verzí v konfiguračních souborech (konfigurační soubor aplikace, soubor zásad vydavatele a konfigurační soubor správce počítače).

PoznámkaPoznámka

Správa verzí se provádí pouze na sestaveních se silnými názvy.

Modul runtime provádí několik kroků k vyřešení požadavků sestavení na vazby:

  1. Kontroluje původní odkaz na sestavení pro zjištění verze sestavení pro svázání.

  2. Zkontroluje všechny vhodné konfigurační soubory pro použití zásad správy verzí.

  3. Určuje správné sestavení z původního odkazu na sestavení a jakéhokoliv přesměrování uvedeného v konfiguračním souboru a určuje verzi, která by měla být svázána s volajícím sestavením.

  4. Kontroluje globální mezipaměť sestavení (GAC), základy kódu v konfiguračních souborech a poté kontroluje adresáře a podadresáře aplikace pomocí pravidel zjišťování, které jsou vysvětleny v How the Runtime Locates Assemblies.

Následující ilustrace znázorňuje tyto kroky.

Řešení požadavků sestavení na vazby

.assembly extern myAssembly

Další informace o konfigurování aplikací naleznete v části Configuration Files. Další informace o zásadách vazby naleznete v How the Runtime Locates Assemblies.

Informace o verzi

Každé sestavení má dva odlišné způsoby vyjádření informace o verzi:

  • Číslo verze sestavení, které spolu s názvem sestavení a informací o jazykové verzi je součástí identity sestavení. Toto číslo je použito modulem runtime k vynucení zásad správy verzí a hraje klíčovou úlohu v procesu rozlišení typu v době běhu.

  • Informační verzi, což je řetězec, který představuje další informace o verzi zahrnuté pouze pro informační účely.

Číslo verze sestavení

Každé sestavení má číslo verze jako součást své identity. Jako takové jsou dvě sestavení, která se liší podle čísla verze považovány modulem runtime za zcela různá sestavení. Toto číslo verze je fyzicky reprezentováno jako řetězec se čtyřmi částmi v následujícím formátu:

<hlavní verze>.<dílčí verze>.<číslo sestavení>.<revize>

Například verze 1.5.1254.0 označuje 1 jako hlavní verzi, 5 jako podverzi, 1254 jako číslo sestavení a 0 jako číslo revize.

Číslo verze je uloženo v manifestu sestavení společně s dalšími informacemi o identitě včetně názvu sestavení a veřejného klíče, stejně jako informace o relacích a identitách jiných sestavení spojených s aplikací.

Když je sestavení sestaveno, vývojářský nástroj zaznamená informaci o závislosti pro každé sestavení, které je odkazováno v manifestu sestavení. Runtime modul používá tato čísla verzí ve spojení s informacemi o konfiguraci, které nastavil správce, aplikace nebo vydavatel k načtení správné verze odkazovaného sestavení.

Runtime modul pro účely správy verzí rozlišuje mezi normálními a silně pojmenovanými sestaveními. Kontrola verze přichází v úvahu pouze u sestavení se silným názvem.

Informace o specifikování zásad k provázání verzí naleznete v tématu Configuration Files. Informace o tom, jak runtime modul používá informace o verzi k vyhledání konkrétního sestavení naleznete v tématu How the Runtime Locates Assemblies.

Informační verze sestavení

Informační verze je řetězec, který připojuje další informace o verzi k sestavení pouze pro informační účely; tyto informace nejsou použity v době běhu. Textově založená informační verze odpovídá marketingové literatuře produktu, balení nebo názvu produktu a není použita modulem runtime. Například informační verze může být: modul CLR (Common Language Runtime) verze 1.0 nebo NET Control SP 2. Tato informace se zobrazí v položce Verze Produktu na kartě verze v dialogovém okně Vlastnosti souboru v systému Microsoft Windows.

PoznámkaPoznámka

Přestože lze zadat libovolný text, zpráva upozornění se zobrazí při kompilaci pokud řetězec není ve formátu, který používá číslo verze sestavení nebo pokud je v tomto formátu, ale obsahuje zástupné znaky.Toto upozornění je neškodné.

Informační verze je reprezentován pomocí vlastního atributu System.Reflection.AssemblyInformationalVersionAttribute. Další informace o atributu informační verze naleznete v tématu Setting Assembly Attributes.

Viz také

Koncepty

How the Runtime Locates Assemblies

Nastavení atributů sestavení

Sestavení v modulu CLR (Common Language Runtime)

Další zdroje

Configuration Files