StackTrace.GetFrames Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une copie de tous les frames de pile dans la trace de la pile actuelle.
public:
cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public:
virtual cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public System.Diagnostics.StackFrame[] GetFrames ();
public virtual System.Diagnostics.StackFrame[] GetFrames ();
public virtual System.Diagnostics.StackFrame?[] GetFrames ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Diagnostics.StackFrame[] GetFrames ();
member this.GetFrames : unit -> System.Diagnostics.StackFrame[]
abstract member GetFrames : unit -> System.Diagnostics.StackFrame[]
override this.GetFrames : unit -> System.Diagnostics.StackFrame[]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetFrames : unit -> System.Diagnostics.StackFrame[]
override this.GetFrames : unit -> System.Diagnostics.StackFrame[]
Public Function GetFrames () As StackFrame()
Public Overridable Function GetFrames () As StackFrame()
Retours
Tableau de type StackFrame représentant les appels de fonctions dans la trace de la pile.
- Attributs
Exemples
L’exemple de code suivant illustre l’énumération des trames dans un StackTrace.
StackTrace^ st = gcnew StackTrace( 1,true );
array<StackFrame^>^stFrames = st->GetFrames();
for ( int i; i < stFrames->Length; i++ )
{
StackFrame^ sf = stFrames[ i ];
Console::WriteLine( "Method: {0}", sf->GetMethod() );
}
StackTrace st = new StackTrace(1, true);
StackFrame [] stFrames = st.GetFrames();
foreach(StackFrame sf in stFrames )
{
Console.WriteLine("Method: {0}", sf.GetMethod() );
}
Dim strace As New StackTrace(1, True)
Dim stFrames As StackFrame() = strace.GetFrames()
Dim sf As StackFrame
For Each sf In stFrames
Console.WriteLine("Method: {0}", sf.GetMethod())
Next sf
Remarques
Utilisez le tableau retourné StackFrame pour énumérer et examiner les appels de fonction dans .StackTrace La longueur du tableau retourné est égale à la valeur de la FrameCount propriété.
Les StackFrame éléments du tableau sont dans l’ordre chronologique inverse. L’index StackFrame de tableau 0 représente l’appel de fonction le plus récent dans la trace de pile et le dernier frame envoyé sur la pile d’appels. L’index StackFrameFrameCount au tableau moins 1 représente l’appel de fonction le plus ancien dans la trace de pile et la première image envoyée à la pile d’appels.
Utilisez la GetFrames méthode pour obtenir tous les trames de pile dans une trace de pile ; utilisez la GetFrame méthode pour obtenir un cadre de pile spécifique dans une trace de pile. Les StackFrame index sont classés de la même façon par les deux méthodes. Par exemple, le à l’index StackFrame 0 dans le tableau retourné par GetFrames équivaut à celui StackFrame retourné par GetFrame avec un index d’entrée de 0.