SatelliteContractVersionAttribute SatelliteContractVersionAttribute SatelliteContractVersionAttribute SatelliteContractVersionAttribute Class

Definición

Indica a un objeto ResourceManager que solicite una versión determinada de un ensamblado satélite.Instructs a ResourceManager object to ask for a particular version of a satellite assembly.

public ref class SatelliteContractVersionAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SatelliteContractVersionAttribute : Attribute
type SatelliteContractVersionAttribute = class
    inherit Attribute
Public NotInheritable Class SatelliteContractVersionAttribute
Inherits Attribute
Herencia
SatelliteContractVersionAttributeSatelliteContractVersionAttributeSatelliteContractVersionAttributeSatelliteContractVersionAttribute
Atributos

Comentarios

Aplicaciones de escritorioDesktop Apps

En las aplicaciones de escritorio SatelliteContractVersionAttribute , el atributo establece un contrato entre un ensamblado principal y todos sus satélites.In desktop apps, the SatelliteContractVersionAttribute attribute establishes a contract between a main assembly and all its satellites. Aplique este atributo al ensamblado principal y pásele el número de versión de los ensamblados satélite que funcionarán con esta versión del ensamblado principal.You apply this attribute to your main assembly, and pass it the version number of the satellite assemblies that will work with this version of the main assembly. Cuando el administrador de recursosResourceManager (objeto) busca recursos, carga explícitamente la versión satélite especificada por este atributo en el ensamblado principal.When the resource manager (ResourceManager object) looks up resources, it explicitly loads the satellite version specified by this attribute on the main assembly.

Cuando se actualiza el ensamblado principal, se incrementa el número de versión del ensamblado.When you update the main assembly, you increment its assembly version number. Sin embargo, es posible que no desee enviar nuevas copias de los ensamblados satélite si los existentes son compatibles con la aplicación.However, you might not want to ship new copies of your satellite assemblies if the existing ones are compatible with your app. En este caso, incremente el número de versión del ensamblado principal y deje el número de versión del contrato satélite igual.In this case, increment the main assembly's version number but leave the satellite contract version number the same. El administrador de recursos utilizará los ensamblados satélite existentes.The resource manager will use your existing satellite assemblies.

Si desea revisar un ensamblado satélite pero no el ensamblado principal, aumente el número de versión en el satélite.If you want to revise a satellite assembly but not the main assembly, increment the version number on your satellite. En este caso, envíe un ensamblado de directiva de edición junto con el ensamblado satélite que indique que el nuevo ensamblado satélite tiene compatibilidad con versiones anteriores con el ensamblado satélite antiguo.In this case, ship a publisher policy assembly along with your satellite assembly stating that your new satellite assembly has backward compatibility with your old satellite assembly. El administrador de recursos seguirá usando el número de contrato anterior escrito en el ensamblado principal en SatelliteContractVersionAttribute función del atributo; sin embargo, el cargador se enlazará a la versión de ensamblado satélite especificada por el ensamblado de directiva.The resource manager will still use the old contract number written into your main assembly based on the SatelliteContractVersionAttribute attribute; however, the loader will bind to the satellite assembly version that is specified by the policy assembly.

Un proveedor de un componente compartido usa un ensamblado de directiva de edición para crear una instrucción de compatibilidad sobre una versión determinada de un ensamblado liberado.A vendor of a shared component uses a publisher policy assembly to make a compatibility statement about a particular version of a released assembly. Un ensamblado de directiva de edición es un ensamblado con nombre seguro que tiene policy.<major>.<minor>.<ComponentAssemblyName>un nombre con el formato y está registrado en.A publisher policy assembly is a strongly named assembly that has a name in the format policy.<major>.<minor>.<ComponentAssemblyName>, and is registered in the . La Directiva de edición se genera a partir de un archivo de configuración XML (vea) mediante la herramienta al. exe (Assembly Linker) .The publisher policy is generated from an XML configuration file (see the ) by using the Al.exe (Assembly Linker) tool. Assembly Linker se usa con la /link opción de vincular el archivo de configuración XML a un ensamblado de manifiesto, que se almacena en la caché global de ensamblados.The Assembly Linker is used with the /link option to link the XML configuration file to a manifest assembly, which is then stored in the global assembly cache. Los ensamblados de directiva de edición se pueden utilizar cuando un proveedor envía una versión de mantenimiento (Service Pack) que contiene correcciones de errores.The publisher policy assemblies can be used when a vendor ships a maintenance release (service pack) that contains bug fixes.

Aplicaciones de Tienda Windows 8.xWindows 8.x StoreTienda Windows 8.xWindows 8.x Store Apps

Este atributo se omite en Tienda Windows 8.xWindows 8.x Store las aplicaciones, porque los archivos de índice de recursos del paquete (PRI) no tienen semántica de control de versiones.This attribute is ignored in Tienda Windows 8.xWindows 8.x Store apps, because package resource index (PRI) files do not have versioning semantics. Además, el Tienda Windows 8.xWindows 8.x Store modelo de empaquetado requiere que todos los recursos se distribuyan en el mismo paquete, sin posibilidad de volver a implementar los ensamblados satélite o los archivos PRI.In addition, the Tienda Windows 8.xWindows 8.x Store packaging model requires all resources to ship in the same package, with no possibility of redeploying satellite assemblies or PRI files.

Constructores

SatelliteContractVersionAttribute(String) SatelliteContractVersionAttribute(String) SatelliteContractVersionAttribute(String) SatelliteContractVersionAttribute(String)

Inicializa una nueva instancia de la clase SatelliteContractVersionAttribute.Initializes a new instance of the SatelliteContractVersionAttribute class.

Propiedades

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
Version Version Version Version

Obtiene la versión de los ensamblados satélites con los recursos necesarios.Gets the version of the satellite assemblies with the required resources.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a