SatelliteContractVersionAttribute Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Instrui um objeto ResourceManager a solicitar uma versão específica de um assembly satélite.
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- Herança
- Atributos
Comentários
Em aplicativos de desktop, o atributo SatelliteContractVersionAttribute estabelece um contrato entre um assembly principal e todos os seus satélites. Você aplica esse atributo ao assembly principal e passa a ele o número de versão dos assemblies satélites que devem funcionar com a mesma versão do assembly principal. Quando o gerenciador de recursos (ResourceManager objeto) pesquisa recursos, ele carrega explicitamente a versão satélite especificada por esse atributo no assembly principal.
Ao atualizar o assembly principal, você incrementa o número de versão do assembly. No entanto, talvez você não queira enviar novas cópias de seus assemblies satélites se os existentes forem compatíveis com seu aplicativo. Nesse caso, incremente o número de versão do assembly principal, mas deixe o número da versão do contrato satélite o mesmo. O gerenciador de recursos usará seus assemblies satélites existentes.
Se quiser revisar um assembly satélite, mas não o assembly principal, incremente o número de versão no satélite. Neste caso, envie um assembly de política de editor junto com seu assembly satélite, informando que seu novo assembly satélite tem compatibilidade retroativa com seu antigo assembly satélite. O gerenciador de recursos ainda usará o número de contrato antigo escrito no assembly principal com base no atributo SatelliteContractVersionAttribute; no entanto, o carregador será vinculado à versão do assembly satélite especificada pelo assembly de política.
Um fornecedor de um componente compartilhado usa um assembly de política de publicação para declarar compatibilidade sobre uma versão específica de um assembly lançado. Um assembly de política do editor é um assembly com nome forte que tem um nome no formato policy.<major>.<minor>.<ComponentAssemblyName>, e é registrado no Cache de Assembly Global (GAC). A política do editor é gerada a partir de um arquivo de configuração XML (consulte o <bindingRedirect> Element) usando a ferramenta Al.exe (Assembly Linker). O Assembly Linker é usado com a opção /link para vincular o arquivo de configuração XML a um assembly de manifesto, que é armazenado no cache de assembly global. Publisher assemblies de política podem ser usados quando um fornecedor envia uma versão de manutenção (service pack) que contém correções de bug, sem exigir que assemblies satélites ou arquivos PRI sejam reimplantados.
Construtores
| Nome | Description |
|---|---|
| SatelliteContractVersionAttribute(String) |
Inicializa uma nova instância da classe SatelliteContractVersionAttribute. |
Propriedades
| Nome | Description |
|---|---|
| TypeId |
Quando implementado em uma classe derivada, obtém um identificador exclusivo para esse Attribute. (Herdado de Attribute) |
| Version |
Obtém a versão dos assemblies satélite com os recursos necessários. |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute) |
| GetHashCode() |
Retorna o código hash dessa instância. (Herdado de Attribute) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsDefaultAttribute() |
Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute) |
| Match(Object) |
Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera as informações de tipo de um objeto, que podem ser usadas para obter as informações de tipo de uma interface. (Herdado de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute) |
