My.Application.Info.StackTrace, propriété

Article
08/21/2008

Mise à jour : novembre 2007

Obtient les informations de traçage de la pile actuelles.

' Usage
Dim value As String = My.Application.Info.StackTrace
' Declaration
Public ReadOnly Property StackTrace As String

Valeur de retour

String qui contient les informations de traçage de la pile actuelles. La valeur de retour peut être Empty.

Exceptions

La condition ci-dessous peut générer une exception :

Les informations de traçage de la pile demandées sont hors limites (ArgumentOutOfRangeException).

Notes

La propriété My.Application.Info.StackTrace répertorie les appels de méthode dans l'ordre chronologique inverse, c'est-à-dire elle décrit d'abord l'appel de méthode le plus récent, puis elle répertorie chaque appel de méthode de la pile sur une ligne disctincte. Toutefois, la propriété My.Application.Info.StackTrace peut ne pas indiquer autant d'appels de méthode que prévu, en raison des transformations de code qui se produisent pendant l'optimisation.

En général, les informations de traçage de la pile sont utilisées pour déboguer des applications.

Les informations de traçage de la pile pour chaque appel de méthode sont mises en forme comme suit :

"à FullClassName.MethodName(MethodParams) dans FileName:ligne LineNumber"

Le littéral "à" est précédé de trois espaces, et les littéraux "dans" et ":ligne" sont omis si les symboles de débogage ne sont pas disponibles. Les espaces réservés FullClassName, MethodName, MethodParams, FileName et LineNumber sont remplacés par des valeurs réelles définies comme suit :

Élément	Description
FullClassName	Nom complet de la classe, y compris l'espace de noms.
MethodName	Nom de la méthode.
MethodParams	Liste des paires type/nom de paramètre. Chaque paire est séparée par une virgule (,). Ces informations sont omises si MethodName n'accepte pas de paramètres.
FileName	Nom du fichier source où la méthode MethodName est déclarée. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.
LineNumber	Numéro de la ligne dans FileName qui contient le code source de MethodName pour l'instruction présente sur la pile des appels. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.

La propriété My.Applicaiton.Info.StackTrace fournit des fonctionnalités semblables à la propriété StackTrace.

Exemple

Cet exemple utilise la propriété My.Application.Info.StackTrace pour afficher la trace de la pile de l'application à partir de laquelle le code s'exécute.

MsgBox("Stack trace: " & My.Application.Info.StackTrace)

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :AssemblyInfo

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non