SatelliteContractVersionAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Indique à un objet ResourceManager de demander une version particulière d’un assembly satellite.
public ref class SatelliteContractVersionAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class SatelliteContractVersionAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SatelliteContractVersionAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
type SatelliteContractVersionAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SatelliteContractVersionAttribute = class
inherit AttributePublic NotInheritable Class SatelliteContractVersionAttribute
Inherits Attribute- Héritage
- Attributs
Remarques
Dans les applications de bureau, l’attribut SatelliteContractVersionAttribute établit un contrat entre un assembly principal et tous ses satellites. Vous appliquez cet attribut à votre assembly principal et transmettez-le le numéro de version des assemblys satellites qui fonctionneront avec cette version de l’assembly principal. Lorsque le gestionnaire de ressources (ResourceManager objet) recherche des ressources, il charge explicitement la version satellite spécifiée par cet attribut sur l’assembly principal.
Lorsque vous mettez à jour l’assembly principal, vous incrémentez son numéro de version d’assembly. Toutefois, vous ne souhaiterez pas envoyer de nouvelles copies de vos assemblages satellites si les assemblages existants sont compatibles avec votre application. Dans ce cas, incrémentez le numéro de version de l’assembly principal, mais laissez le numéro de version du contrat satellite identique. Le gestionnaire de ressources utilisera vos assemblages satellites existants.
Si vous souhaitez réviser un assemblage satellite, mais pas l’assemblage principal, incrémentez le numéro de version de votre satellite. Dans ce cas, expédiez un assemblage de stratégie d'éditeur avec votre assemblage satellite, indiquant que votre nouvel assemblage satellite est rétrocompatible avec votre ancien assemblage satellite. Le gestionnaire de ressources continuera à utiliser l’ancien numéro de contrat inscrit dans votre assembly principal en fonction de l’attribut SatelliteContractVersionAttribute. Toutefois, le chargeur s'associera à la version de l’assembly satellite indiquée par l’assembly de stratégie.
Un fournisseur d’un composant partagé utilise un assembly de stratégie d’éditeur pour effectuer une instruction de compatibilité sur une version particulière d’un assembly publié. Un assembly de stratégie d’éditeur est un assembly fortement nommé qui a un nom au format policy.<major>.<minor>.<ComponentAssemblyName>et qui est inscrit dans le Global Assembly Cache (GAC). La politique de l'éditeur est générée à partir d’un fichier de configuration XML (voir l’élément <bindingRedirect>) à l’aide de l’outil Al.exe (Assembly Linker). Assembly Linker est utilisé avec l’option /link permettant de lier le fichier de configuration XML à un assembly manifeste, qui est ensuite stocké dans le Global Assembly Cache. Publisher assemblys de stratégie peuvent être utilisés lorsqu’un fournisseur envoie une version de maintenance (Service Pack) qui contient des correctifs de bogues, sans nécessiter de redéploiement d’assemblys satellites ou de fichiers PRI.
Constructeurs
| Nom | Description |
|---|---|
| SatelliteContractVersionAttribute(String) |
Initialise une nouvelle instance de la classe SatelliteContractVersionAttribute. |
Propriétés
| Nom | Description |
|---|---|
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
| Version |
Obtient la version des assemblys satellites avec les ressources requises. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDefaultAttribute() |
En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute) |
