Type.FullName Propriedade

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

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.

Obtém o nome totalmente qualificado do tipo, incluindo o namespace, mas não o assembly.

public:
 abstract property System::String ^ FullName { System::String ^ get(); };

public abstract string FullName { get; }

public abstract string? FullName { get; }

member this.FullName : string

Public MustOverride ReadOnly Property FullName As String

Valor da propriedade

String

O nome totalmente qualificado do tipo, incluindo o namespace, mas não o assembly; ou null, se a instância atual representar um parâmetro de tipo genérico, um tipo de matriz, um tipo de ponteiro ou um tipo byref baseado em um parâmetro de tipo, ou um tipo genérico que não é uma definição de tipo genérica, mas que contém parâmetros de tipo não resolvidos.

Implementações

FullName

Exemplos

O exemplo a seguir exibe o nome completo do tipo especificado.

using namespace System;
int main()
{
   Type^ t = Array::typeid;
   Console::WriteLine( "The full name of the Array type is {0}.", t->FullName );
}

/* This example produces the following output:

The full name of the Array type is System.Array.
 */

using System;
class TestFullName
{
public static void Main()
    {
    Type t = typeof(Array);
    Console.WriteLine("The full name of the Array type is {0}.", t.FullName);
    }
}

/* This example produces the following output:

The full name of the Array type is System.Array.
 */

Class TestFullName
   
    Public Shared Sub Main()
        Dim t As Type = GetType(Array)
        Console.WriteLine("The full name of the Array type is {0}.", t.FullName)
    End Sub
End Class

' This example produces the following output:
'
'The full name of the Array type is System.Array.
'

O exemplo a seguir compara as cadeias de caracteres retornadas pelo método e ToString as propriedades , e Name FullName AssemblyQualifiedName .

using System;
using System.Collections.Generic;
using System.Globalization;

public class Example
{
    public static void Main()
    {
        Type t = typeof(String);
        ShowTypeInfo(t);

        t = typeof(List<>);
        ShowTypeInfo(t);

        var list = new List<String>();
        t = list.GetType();
        ShowTypeInfo(t);

        Object v = 12;
        t = v.GetType();
        ShowTypeInfo(t);

        t = typeof(IFormatProvider);
        ShowTypeInfo(t);

        IFormatProvider ifmt = NumberFormatInfo.CurrentInfo;
        t = ifmt.GetType();
        ShowTypeInfo(t);
    }

    private static void ShowTypeInfo(Type t)
    {
        Console.WriteLine($"Name: {t.Name}");
        Console.WriteLine($"Full Name: {t.FullName}");
        Console.WriteLine($"ToString:  {t}");
        Console.WriteLine($"Assembly Qualified Name: {t.AssemblyQualifiedName}");
        Console.WriteLine();
    }
}
// The example displays output like the following:
//    Name: String
//    Full Name: System.String
//    ToString:  System.String
//    Assembly Qualified Name: System.String, mscorlib, Version=4.0.0.0, Culture=neutr
//    al, PublicKeyToken=b77a5c561934e089
//
//    Name: List`1
//    Full Name: System.Collections.Generic.List`1
//    ToString:  System.Collections.Generic.List`1[T]
//    Assembly Qualified Name: System.Collections.Generic.List`1, mscorlib, Version=4.
//    0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
//
//    Name: List`1
//    Full Name: System.Collections.Generic.List`1[[System.String, mscorlib, Version=4
//    .0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
//    ToString:  System.Collections.Generic.List`1[System.String]
//    Assembly Qualified Name: System.Collections.Generic.List`1[[System.String, mscor
//    lib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]], mscorl
//    ib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
//
//    Name: Int32
//    Full Name: System.Int32
//    ToString:  System.Int32
//    Assembly Qualified Name: System.Int32, mscorlib, Version=4.0.0.0, Culture=neutra
//    l, PublicKeyToken=b77a5c561934e089
//
//    Name: IFormatProvider
//    Full Name: System.IFormatProvider
//    ToString:  System.IFormatProvider
//    Assembly Qualified Name: System.IFormatProvider, mscorlib, Version=4.0.0.0, Cult
//    ure=neutral, PublicKeyToken=b77a5c561934e089
//
//    Name: NumberFormatInfo
//    Full Name: System.Globalization.NumberFormatInfo
//    ToString:  System.Globalization.NumberFormatInfo
//    Assembly Qualified Name: System.Globalization.NumberFormatInfo, mscorlib, Versio
//    n=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

Imports System.Collections.Generic
Imports System.Globalization

Module Example
    Public Sub Main()
        Dim t As Type = GetType(String)
        ShowTypeInfo(t)

        t = GetType(List(Of))
        ShowTypeInfo(t)

        Dim list As New List(Of String)()
        t = list.GetType()
        ShowTypeInfo(t)

        Dim v As Object = 12
        t = v.GetType()
        ShowTypeInfo(t)

        t = GetType(IFormatProvider)
        ShowTypeInfo(t)

        Dim ifmt As IFormatProvider = NumberFormatInfo.CurrentInfo
        t = ifmt.GetType()
        ShowTypeInfo(t)
    End Sub

    Private Sub ShowTypeInfo(t As Type)
        Console.WriteLine($"Name: {t.Name}")
        Console.WriteLine($"Full Name: {t.FullName}")
        Console.WriteLine($"ToString:  {t}")
        Console.WriteLine($"Assembly Qualified Name: {t.AssemblyQualifiedName}")
        Console.WriteLine()
    End Sub
End Module
' The example displays output like the following:
'    Name: String
'    Full Name: System.String
'    ToString:  System.String
'    Assembly Qualified Name: System.String, mscorlib, Version=4.0.0.0, Culture=neutr
'    al, PublicKeyToken=b77a5c561934e089
'
'    Name: List`1
'    Full Name: System.Collections.Generic.List`1
'    ToString:  System.Collections.Generic.List`1[T]
'    Assembly Qualified Name: System.Collections.Generic.List`1, mscorlib, Version=4.
'    0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
'
'    Name: List`1
'    Full Name: System.Collections.Generic.List`1[[System.String, mscorlib, Version=4
'    .0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
'    ToString:  System.Collections.Generic.List`1[System.String]
'    Assembly Qualified Name: System.Collections.Generic.List`1[[System.String, mscor
'    lib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]], mscorl
'    ib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
'
'    Name: Int32
'    Full Name: System.Int32
'    ToString:  System.Int32
'    Assembly Qualified Name: System.Int32, mscorlib, Version=4.0.0.0, Culture=neutra
'    l, PublicKeyToken=b77a5c561934e089
'
'    Name: IFormatProvider
'    Full Name: System.IFormatProvider
'    ToString:  System.IFormatProvider
'    Assembly Qualified Name: System.IFormatProvider, mscorlib, Version=4.0.0.0, Cult
'    ure=neutral, PublicKeyToken=b77a5c561934e089
'
'    Name: NumberFormatInfo
'    Full Name: System.Globalization.NumberFormatInfo
'    ToString:  System.Globalization.NumberFormatInfo
'    Assembly Qualified Name: System.Globalization.NumberFormatInfo, mscorlib, Versio
'    n=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

Comentários

Por exemplo, o nome totalmente qualificado do String tipo é System.String . Contraste isso com o nome qualificado pelo assembly retornado pela propriedade , que consiste no AssemblyQualifiedName nome completo mais o nome completo do assembly.

Se o tipo atual representar um tipo genérico fechado, os argumentos de tipo na cadeia de caracteres retornada pela propriedade serão qualificados pelo nome completo do assembly, mesmo que a representação de cadeia de caracteres do próprio tipo genérico não seja qualificada pelo nome completo do FullName assembly. O exemplo a seguir ilustra a diferença na propriedade FullName para um tipo que representa a definição de tipo genérico e um que representa um tipo genérico fechado.

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      Type t = typeof(List<>);
      Console.WriteLine(t.FullName);
      Console.WriteLine();

      List<String> list = new List<String>();
      t = list.GetType();
      Console.WriteLine(t.FullName);
   }
}
// The example displays the following output:
// System.Collections.Generic.List`1
//
// System.Collections.Generic.List`1[[System.String, mscorlib,
//        Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim t As Type = GetType(List(Of))
      Console.WriteLine(t.FullName)
      Console.WriteLine()

      Dim list As New List(Of String)()
      t = list.GetType()
      Console.WriteLine(t.FullName)
   End Sub
End Module
' The example displays the following output:
'    System.Collections.Generic.List`1
'
'    System.Collections.Generic.List`1[[System.String, mscorlib,
'             Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Essa propriedade retornará null se:

O objeto Type atual representa um parâmetro de tipo de um tipo genérico.

O exemplo a seguir recupera o parâmetro type do Nullable<T> tipo e tenta exibir sua FullName propriedade.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      Type t = typeof(Nullable<>); 
      Console.WriteLine(t.FullName);
      if (t.IsGenericType) {
         Console.Write("   Generic Type Parameters: ");
         Type[] gtArgs = t.GetGenericArguments();
         for (int ctr = 0; ctr < gtArgs.Length; ctr++) {
            Console.WriteLine(gtArgs[ctr].FullName ??
                              "(unassigned) " + gtArgs[ctr].ToString());
          }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       System.Nullable`1
//          Generic Type Parameters: (unassigned) T

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim t As Type = GetType(Nullable(Of )) 
      Console.WriteLine(t.FullName)
      If t.IsGenericType Then
         Console.Write("   Generic Type Parameters: ")
         Dim gtArgs As Type() = t.GetGenericArguments
         For ctr As Integer = 0 To gtArgs.Length - 1
            Console.WriteLine(If(gtArgs(ctr).FullName, 
                              "(unassigned) " + gtArgs(ctr).ToString()))
            If ctr < gtArgs.Length - 1 Then Console.Write(", ")   
         Next
         Console.WriteLine()
      End If
   End Sub
End Module
' The example displays the following output:
'       System.Nullable`1
'          Generic Type Parameters: (unassigned) T

O objeto atual representa um tipo de matriz, um tipo de ponteiro ou Type um tipo baseado em um parâmetro de tipo byref genérico.

O exemplo a seguir define um tipo genérico, , com três métodos: , que é passado uma matriz do tipo T; , que é passado um objeto T; e , que é passado um objeto T por Generictype1<T> Display(T[]) HandleT(T) ChangeValue(ref T) referência. Como C# e Visual Basic não nos permitem definir T como um ponteiro no método , precisamos chamar o método no objeto que representa o tipo de parâmetro do método para criar um ponteiro para um tipo HandleT MakePointerType Type genérico. A saída do exemplo mostra que, em todos os três casos, a FullName propriedade é null .

using System;
using System.Reflection;

public class GenericType1<T> 
{
   public void Display(T[] elements)  
   {}
   
   public void HandleT(T obj)
   {}
   
   public bool ChangeValue(ref T arg) 
   {
      return true;
   }
}

public class Example
{
   public static void Main()
   {
      Type t = typeof(GenericType1<>);
      Console.WriteLine("Type Name: {0}", t.FullName);
      MethodInfo[] methods = t.GetMethods(BindingFlags.Instance |
                                          BindingFlags.DeclaredOnly |
                                          BindingFlags.Public);
      foreach (var method in methods) { 
         Console.WriteLine("   Method: {0}", method.Name);
         // Get method parameters.
         ParameterInfo param = method.GetParameters()[0];
         Type paramType = param.ParameterType;
         if (method.Name == "HandleT")
            paramType = paramType.MakePointerType();
         Console.WriteLine("      Parameter: {0}", 
                           paramType.FullName ?? 
                           paramType.ToString() + " (unassigned)");
      }
   }
}
// The example displays the following output:
//       Type Name: GenericType1`1
//          Method: Display
//             Parameter: T[] (unassigned))
//          Method: HandleT
//             Parameter: T* (unassigned)
//          Method: ChangeValue
//             Parameter: T& (unassigned)

Imports System.Reflection

Public Class GenericType1(Of T)
   Public Sub Display(elements As T())
   End Sub
   
   ' Visual Basic does not support pointer types.
   Public Sub HandleT(obj As T)
   End Sub
   
   
   Public Function ChangeValue(ByRef arg As T) As Boolean
      Return True
   End Function
End Class

Module Example
   Public Sub Main()
      Dim t As Type = GetType(GenericType1(Of ))
      Console.WriteLine("Type Name: {0}", t.FullName)
      Dim methods() As MethodInfo = t.GetMethods(BindingFlags.Instance Or
                                                 BindingFlags.DeclaredOnly Or
                                                 BindingFlags.Public)
      For Each method In methods 
         Console.WriteLine("   Method: {0}", method.Name)
         ' Get method parameters.
         Dim param As ParameterInfo = method.GetParameters()(0)
         Dim paramType As Type = param.ParameterType
         If method.Name = "HandleT" Then
            paramType = paramType.MakePointerType()
         End If
         Console.WriteLine("      Parameter: {0}", 
                           If(paramType.FullName, 
                              paramType.ToString() + " (unassigned)"))
      Next
   End Sub
End Module
' The example displays the following output:
'       Type Name: GenericType1`1
'          Method: Display
'             Parameter: T[] (unassigned)
'          Method: HandleT
'             Parameter: T* (unassigned)
'          Method: ChangeValue
'             Parameter: T& (unassigned)

O tipo atual contém parâmetros de tipo genérico que não foram substituídos por tipos específicos (ou seja, a propriedade retorna ), mas o tipo não é uma definição de tipo genérico ContainsGenericParameters true (ou seja, a propriedade retorna IsGenericTypeDefinitionfalse

No exemplo a seguir, Derived<T> herda de Base<T> . A BaseType propriedade obtém o Type objeto que representa o tipo base de e sua propriedade retorna Derived<T> FullName null .

using System;
using System.Reflection;

public class Base<T> { }

public class Derived<T> : Base<T> { }

public class Example
{
   public static void Main()
   {
      Type t = typeof(Derived<>);
      Console.WriteLine("Generic Class: {0}", t.FullName);
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        t.ContainsGenericParameters);
      Console.WriteLine("   Generic Type Definition: {0}\n",
                        t.IsGenericTypeDefinition);                 

      Type baseType = t.BaseType;
      Console.WriteLine("Its Base Class: {0}", 
                        baseType.FullName ?? 
                        "(unassigned) " + baseType.ToString());
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        baseType.ContainsGenericParameters);
      Console.WriteLine("   Generic Type Definition: {0}",
                        baseType.IsGenericTypeDefinition);                 
      Console.WriteLine("   Full Name: {0}\n", 
                        baseType.GetGenericTypeDefinition().FullName);

      t = typeof(Base<>);
      Console.WriteLine("Generic Class: {0}", t.FullName);
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        t.ContainsGenericParameters);
      Console.WriteLine("   Generic Type Definition: {0}\n",
                        t.IsGenericTypeDefinition);                 
   }
}
// The example displays the following output:
//       Generic Class: Derived`1
//          Contains Generic Paramters: True
//          Generic Type Definition: True
//       
//       Its Base Class: (unassigned) Base`1[T]
//          Contains Generic Paramters: True
//          Generic Type Definition: False
//          Full Name: Base`1
//       
//       Generic Class: Base`1
//          Contains Generic Paramters: True
//          Generic Type Definition: True

Imports System.Reflection

Public Class Base(Of T)
End Class

Public Class Derived(Of T) : Inherits Base(Of T)
End Class

Module Example
   Public Sub Main()
      Dim t As Type = GetType(Derived(Of ))
      Console.WriteLine("Generic Class: {0}", t.FullName)
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        t.ContainsGenericParameters)
      Console.WriteLine("   Generic Type Definition: {0}",
                        t.IsGenericTypeDefinition)                 
      Console.WriteLine()
      
      Dim baseType As Type = t.BaseType
      Console.WriteLine("Its Base Class: {0}", 
                        If(baseType.FullName,  
                        "(unassigned) " + baseType.ToString()))
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        baseType.ContainsGenericParameters)
      Console.WriteLine("   Generic Type Definition: {0}",
                        baseType.IsGenericTypeDefinition)                 
      Console.WriteLine("   Full Name: {0}", 
                        baseType.GetGenericTypeDefinition().FullName)
      Console.WriteLine()
      
      t = GetType(Base(Of ))
      Console.WriteLine("Generic Class: {0}", t.FullName)
      Console.WriteLine("   Contains Generic Paramters: {0}",
                        t.ContainsGenericParameters)
      Console.WriteLine("   Generic Type Definition: {0}",
                        t.IsGenericTypeDefinition)                 
   End Sub
End Module
' The example displays the following output:
'       Generic Class: Derived`1
'          Contains Generic Paramters: True
'          Generic Type Definition: True
'       
'       Its Base Class: (unassigned) Base`1[T]
'          Contains Generic Paramters: True
'          Generic Type Definition: False
'          Full Name: Base`1
'       
'       Generic Class: Base`1
'          Contains Generic Paramters: True
'          Generic Type Definition: True

Para obter um que não é , você pode usar o método para obter a definição de tipo FullName null GetGenericTypeDefinition genérico, como ilustra o exemplo.

Esta propriedade é somente para leitura.

Aplica-se a

Partilhar via