TypeName, fonction (Visual Basic)

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une valeur String contenant des informations sur le type de données d'une variable.

Public Function TypeName(ByVal VarName As Object) As String

Paramètres

VarName
Requis. Variable Object. Si Option Strict est Off, vous pouvez passer une variable de n'importe quel type de données à l'exception d'une structure.

Notes

Le tableau suivant illustre les valeurs String retournées par TypeName pour différents contenus de VarName.

Contenu de VarName.	Chaîne retournée
Type valeur True ou False 16 bits	"Boolean"
Type valeur binaire 8 bits	"Byte"
Type valeur de caractère 16 bits	"Char"
Type valeur de date et heure 64 bits	"Date"
Type référence indiquant des données manquantes ou inexistantes	"DBNull"
Type valeur numérique à virgule fixe 128 bits	"Decimal"
Type valeur numérique à virgule flottante 64 bits	"Double"
Type valeur entier 32 bits	"Integer"
Type référence pointant vers un objet non spécialisé	"Object"
Type référence pointant vers un objet spécialisé créé à partir de la classe ObjetClasse	"ObjetClasse"
Type valeur entier 64 bits	"Long"
Type référence auquel aucun objet n'est actuellement assigné	"Nothing"
Type valeur entier 8 bits signé	"SByte"
Type valeur entier 16 bits	"Short"
Type valeur numérique à virgule flottante 32 bits	"Single"
Type référence pointant vers une chaîne de caractères 16 bits	"String"
Type valeur entier 32 bits non signé	"UInteger"
Type valeur entier 64 bits non signé	"ULong"
Type valeur entier 16 bits non signé	"UShort"

Si VarName est un tableau, la chaîne retournée peut être l'une des chaînes du tableau précédent suivie de parenthèses vides. Par exemple, si VarName pointe vers un tableau d'entiers, TypeName retourne "Integer()".

Lorsque TypeName retourne le nom d'un type référence tel qu'une classe, la fonction retourne uniquement le nom lui-même et pas le nom qualifié. Par exemple, si VarName pointe vers un objet de classe System.Drawing.Printing.PaperSource, TypeName retourne "PaperSource". Notez que si la variable est déclarée comme étant d'un certain type de classe, mais qu'aucun objet ne lui a été assigné, TypeName retourne "Nothing".

Exemple

L'exemple suivant utilise la fonction TypeName pour retourner des informations sur les types de données concernant plusieurs variables.

Dim testType As String
Dim strVar As String = "String for testing"
Dim decVar As Decimal
Dim intVar, arrayVar(5) As Integer
testType = TypeName(strVar)
' The preceding call returns "String".
testType = TypeName(decVar)
' The preceding call returns "Decimal".
testType = TypeName(intVar)
' The preceding call returns "Integer".
testType = TypeName(arrayVar)
' The preceding call returns "Integer()".