Clase TypeLibVersionAttribute

 

Publicado: octubre de 2016

Especifica el número de versión de una biblioteca de tipos exportada.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Jerarquía de herencia

System.Object
  System.Attribute
    System.Runtime.InteropServices.TypeLibVersionAttribute

Sintaxis

[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class TypeLibVersionAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public ref class TypeLibVersionAttribute sealed : Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)>]
[<ComVisibleAttribute(true)>]
type TypeLibVersionAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited := False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class TypeLibVersionAttribute
    Inherits Attribute

Constructores

	Nombre	Descripción
	TypeLibVersionAttribute(Int32, Int32)	Inicializa una nueva instancia de la TypeLibVersionAttribute clase con los números de versión principal y secundaria de la biblioteca de tipos.

Propiedades

	Nombre	Descripción
	MajorVersion	Obtiene el número de versión principal de la biblioteca de tipos.
	MinorVersion	Obtiene el número de versión secundaria de la biblioteca de tipos.
	TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

Métodos

	Nombre	Descripción
	Equals(Object)	Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia es igual que un objeto especificado.(Heredado de Attribute).
	GetHashCode()	Devuelve el código hash de esta instancia.(Heredado de Attribute).
	GetType()	Obtiene el Type de la instancia actual.(Heredado de Object).
	IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).
	Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.(Heredado de Attribute).
	ToString()	Devuelve una cadena que representa el objeto actual.(Heredado de Object).

Implementaciones de interfaz explícitas

	Nombre	Descripción
	_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).
	_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.(Heredado de Attribute).
	_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).
	_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Comentarios

Este atributo se puede aplicar a los ensamblados.

De forma predeterminada, la Tlbexp.exe (Type Library Exporter) genera una versión de la biblioteca de tipos desde los primeros dos números de versión de un ensamblado. Por ejemplo, Tlb.exe exporta la versión de ensamblado 1.2.5000.0 como versión de biblioteca de tipos 1.2, eliminando los números de compilación y revisión del ensamblado. Si no desea este comportamiento, puede controlar explícitamente la generación del número de la biblioteca de tipos aplicando el TypeLibVersionAttribute.

Es útil controlar explícitamente la generación de una versión de la biblioteca de tipos cuando dos versiones de ensamblado generan la misma versión de biblioteca de tipos. Por ejemplo, la versión de ensamblado 1.2.0.0 y la versión de ensamblado 1.2.500.0 ambas generan una versión de la biblioteca de tipos de 1,2, lo que puede causar problemas al desinstalar uno de los ensamblados. Para diferenciar las versiones de la biblioteca de tipos, puede forzar el segundo ensamblado (versión 1.2.500.0) para generar una versión de la biblioteca de tipos de 1,25.

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar el TypeLibVersionAttribute para establecer explícitamente la versión de la biblioteca de tipos en 1.25.

using System;
using System.Reflection;
using System.Runtime.InteropServices;

[assembly: AssemblyVersion("1.2.500.0")]
[assembly: TypeLibVersion(1,25)]
namespace MyNamespace
{
    public class TheClass
    {
        // Insert code.
    }
}

Imports System
Imports System.Reflection
Imports System.Runtime.InteropServices

<Assembly: AssemblyVersion("1.2.500.0")>
<Assembly: TypeLibVersion(1,25)>
Namespace MyNamespace
    Public Class TheClass
        ' Insert code.
    End Class
End Namespace

using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;

[assembly: AssemblyVersion("1.2.500.0")];
[assembly: TypeLibVersion(1,25)];
namespace MyNamespace
{
    public ref class TheClass
    {
        // Insert code.
    };
};

Información de versión

.NET Framework
Disponible desde 1.1

Seguridad para subprocesos

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Ver también

Espacio de nombres System.Runtime.InteropServices
Tlbexp.exe (Type Library Exporter)

Volver al principio