Esta documentación está archivada y no tiene mantenimiento.

Type.AssemblyQualifiedName (Propiedad)

Actualización: noviembre 2007

Obtiene el nombre completo del ensamblado de Type, que incluye el nombre del ensamblado a partir del cuál se ha cargado Type.

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

public abstract string AssemblyQualifiedName { get; }
/** @property */
public abstract String get_AssemblyQualifiedName()

public abstract function get AssemblyQualifiedName () : String

Valor de propiedad

Tipo: System.String
Nombre completo del ensamblado de Type, que incluye el nombre del ensamblado a partir del cual se ha cargado Type, o null si la instancia actual representa un parámetro de tipo genérico.

Implementaciones

_Type.AssemblyQualifiedName

El nombre completo de ensamblado de un tipo está formado por el nombre de tipo, incluido su espacio de nombres, seguido de una coma y del nombre para mostrar del ensamblado. El nombre para mostrar de un ensamblado se obtiene utilizando la propiedad Assembly.FullName.

30wyt9tk.alert_note(es-es,VS.90).gifNota:

En .NET Framework versión 2.0, la arquitectura del procesador se agrega a la identidad del ensamblado, y se puede especificar como parte de las cadenas de nombre de ensamblado. Por ejemplo, "ProcessorArchitecture=msil". Sin embargo, por razones de compatibilidad, no se incluye en la cadena devuelta por la propiedad AssemblyQualifiedName. Vea AssemblyName.ProcessorArchitecture.

Todos los compiladores que admitan Common Language Runtime emitirán el nombre sencillo de una clase anidada. La reflexión construye un nombre con sufijo cuando se ejecuta la consulta, de acuerdo con las convenciones siguientes.

Delimitador

Significado

Barra diagonal inversa (\)

Carácter de escape.

Coma (,)

Precede al nombre del ensamblado.

Signo más (+)

Precede a una clase anidada.

Punto (.)

Denota los identificadores del espacio de nombres.

Corchetes ([])

Después de un nombre de tipo, denota una matriz de ese tipo.

-O bien-

Para tipos genéricos, encierra la lista de argumentos de tipo genérico.

-O bien-

Dentro de una lista de argumentos de tipo, encierra un tipo de ensamblado completo.

Por ejemplo, el nombre completo del ensamblado para una clase podría ser similar al siguiente:

TopNamespace.SubNameSpace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089

Si el espacio de nombres contenía un signo más, por ejemplo, TopNamespace.Sub+Namespace, entonces el signo más (+) debería ir precedido de un carácter de escape (\) para impedir que se interprete como separador de anidamiento. La reflexión emitiría esta cadena de la forma siguiente:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089 

"++" se convierte en "\+\+" y "\" se convierte en "\\".

Este nombre completo se puede conservar y utilizarse más adelante para cargar el objeto Type. Para buscar y cargar Type, hay que utilizar el método GetType sólo con el nombre de tipo o con el nombre completo del tipo de ensamblado. Si se utiliza el método GetType sólo con el nombre de tipo, se buscará Type en el ensamblado del llamador y, después, en el ensamblado System. Si se utiliza el método GetType con el nombre completo del tipo de ensamblado, se buscará Type en cualquier ensamblado.

Los nombres de tipo pueden contener caracteres finales que denoten información adicional acerca del tipo, por ejemplo, si se trata de un tipo de referencia, un tipo de puntero o un tipo de matriz. Para recuperar el nombre de tipo sin estos caracteres finales, hay que utilizar t.GetElementType().ToString(), donde t es el tipo.

Los espacios son significativos en todos los componentes de un nombre de tipo excepto en el caso del nombre de ensamblado. En el nombre de ensamblado, los espacios situados antes del separador ',' son significativos, pero los situados después se pasan por alto.

Los propios argumentos genéricos de los tipos genéricos están calificados por el nombre del ensamblado. Por ejemplo, en el nombre completo de ensamblado del tipo para MyGenericClass<int> (MyGenericClass(Of Integer) en Visual Basic), int se expande al nombre completo de ensamblado del tipo para Int32.

Si el objeto Type actual representa un parámetro genérico, esta propiedad devuelve null.

En el siguiente ejemplo se muestra el nombre de ensamblado asociado a la clase y el nombre completo del tipo.

using System;
using System.Reflection;

class MyAssemblyClass
{

    public static void Main()
    {
        Type objType = typeof(System.Array);

        // Print the full assembly name.
        Console.WriteLine ("Full assembly name: {0}.", objType.Assembly.FullName.ToString()); 

        // Print the qualified assembly name.
        Console.WriteLine ("Qualified assembly name: {0}.", objType.AssemblyQualifiedName.ToString()); 
    }
}


import System.*;
import System.Reflection.*;

class MyAssemblyClass
{
    public static void main(String[] args)
    {
        Type objType = System.Array.class.ToType();
        // Print the full assembly name.
        Console.WriteLine("Full assembly name: {0}.",
            objType.get_Assembly().get_FullName().ToString());
        // Print the qualified assembly name.
        Console.WriteLine("Qualified assembly name: {0}.",
            objType.get_AssemblyQualifiedName().ToString());
    } //main
} //MyAssemblyClass


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: