Propriedade My.Application.Info.StackTrace

Artigo
08/25/2010

Obtém as informações do rastreamento de pilha atual.

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

Valor de retorno

Valor de propriedade

Uma String contendo as informações de rastreamento de pilha atual.O valor de retorno pode ser Empty.

Exceções

A condição a seguir pode causar uma exceção:

As informações solicitadas do rastreamento de pilha estão fora de alcançe (ArgumentOutOfRangeException).

Comentários

A propriedade My.Application.Info.StackTrace listas chamadas de método em ordem cronológica inversa — isto é, ela descreve a chamada de método mais recente primeiro, e ela listará cada chamada de método na pilha em uma linha separada.No entanto, a propriedade My.Application.Info.StackTrace pode não relatar tantas chamadas de método conforme esperado, devido às transformações de código que ocorrem durante a otimização.

Normalmente, as informações de rastreamento pilha são usadas para depurar aplicativos.

As informações de rastreamento de pilha para cada chamada de método são formatadas da seguinte maneira:

" at FullClassName .. MethodName (MethodParams) no filename : line LineNumber "

O literal "at "é precedido por três espaços e os literais" in" e ":line " são omitidos se símbolos de depuração não estiverem disponíveis.Os espaços reservados FullClassName, MethodName, MethodParams, FileName e LineNumber são substituídos pelos valores reais, definidos da seguinte maneira:

Parte	Descrição
FullClassName	O nome completo da classe, incluindo o namespace.
MethodName	O nome do método.
MethodParams	A lista de pares nome/tipo de parâmetroCada par é separado por uma vírgula (,).Essa informação é omitida se MethodName não recebe nenhum parâmetro.
FileName	O nome do arquivo de código-fonte onde o método MethodName é declarado.Essa informação é omitida se símbolos de depuração não estiverem disponíveis.
LineNumber	O número da linha em FileName que contém o código-fonte de MethodName para a instrução que está na pilha de chamada.Essa informação é omitida se símbolos de depuração não estiverem disponíveis.

A propriedade My.Applicaiton.Info.StackTrace fornece funcionalidade semelhante à propriedade StackTrace.

Exemplo

Este exemplo usa a propriedade My.Application.Info.StackTrace para exibir o rastreamento de pilha do aplicativo a partir do ponto em que o código é executado.

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

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:AssemblyInfo

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Não
Serviço do Windows	Sim
Site	Não