Aufruferinformationen (C# und Visual Basic)

Mit Anrufer-Informationens Attribute verwenden, können Sie Informationen über den Aufrufer an eine Methode abgerufen.Sie erhalten Dateipfad des Quellcodes, Zeilennummer im Quellcode und Member des Namens des Aufrufers.Diese Informationen sind für das Debuggen, die Ablaufverfolgung und das Erstellen von Diagnosetools hilfreich.

Zum Abrufen dieser Informationen verwenden Sie die Attribute zu den optionalen Parameter angewendet werden, die jeweils über einen Standardwert verfügt.In der folgenden Tabelle sind die Attribute aufgeführt, die im Anrufer-Informationens System.Runtime.CompilerServices-Namespace definiert sind:

Beispiel

Im folgenden Beispiel wird gezeigt, wie Anrufer-Informationens von Attributen verwendet.Bei jedem Aufruf der TraceMessage Informationen zum Aufrufer, werden die Methode als Argumente für optionale Parameter ersetzt.

' Imports System.Runtime.CompilerServices
' Imports System.Diagnostics

Private Sub DoProcessing()
    TraceMessage("Something happened.")
End Sub

Public Sub TraceMessage(message As String,
        <CallerMemberName> Optional memberName As String = Nothing,
        <CallerFilePath> Optional sourcefilePath As String = Nothing,
        <CallerLineNumber()> Optional sourceLineNumber As Integer = 0)

    Trace.WriteLine("message: " & message)
    Trace.WriteLine("member name: " & memberName)
    Trace.WriteLine("source file path: " & sourcefilePath)
    Trace.WriteLine("source line number: " & sourceLineNumber)
End Sub

' Sample output:
'   message: Something happened.
'   member name: DoProcessing
'   source file path: C:\Users\username\Documents\Visual Studio 2012\Projects\CallerInfoVB\CallerInfoVB\Form1.vb
'   source line number: 15

// using System.Runtime.CompilerServices
// using System.Diagnostics;

public void DoProcessing()
{
    TraceMessage("Something happened.");
}

public void TraceMessage(string message,
        [CallerMemberName] string memberName = "",
        [CallerFilePath] string sourceFilePath = "",
        [CallerLineNumber] int sourceLineNumber = 0)
{
    Trace.WriteLine("message: " + message);
    Trace.WriteLine("member name: " + memberName);
    Trace.WriteLine("source file path: " + sourceFilePath);
    Trace.WriteLine("source line number: " + sourceLineNumber);
}

// Sample Output:
//  message: Something happened.
//  member name: DoProcessing
//  source file path: c:\Users\username\Documents\Visual Studio 2012\Projects\CallerInfoCS\CallerInfoCS\Form1.cs
//  source line number: 31

Hinweise

Sie müssen ein expliziter Standardwert für jeden optionalen Parameter angeben.Sie können Attribute Anrufer-Informationens nicht auf Parameter angewendet werden, die nicht als optional angegeben werden.

Die Attribute Anrufer-Informationens machen einen Parameter nicht optional.Stattdessen haben sie den Standardwert, der übergeben wird, wenn das Argument weggelassen wird.

Anrufer-Informationens Werte werden als Literale in die Intermediate Language (IL) zur Kompilierzeit ausgegeben.Im Gegensatz zu den Ergebnissen der StackTrace-Eigenschaft für Ausnahmen sind die Ergebnisse nach dem Verbergen nicht betroffen.

Member-Namen

Sie können das CallerMemberName-Attribut verwenden, um den Membernamen String als Argument an die aufgerufene Methode festzulegen zu vermeiden.Wenn Sie dieses Verfahren verwenden, vermeiden Sie das Problem, dass Benennen Sie die Umgestaltung nicht die String-Werte ändert.Dieser Vorteil ist besonders nützlich für die folgenden Aufgaben:

• Verwenden der Ablaufverfolgung und der Diagnoseprogramme.

• Die INotifyPropertyChanged-Schnittstelle implementieren, wenn Daten gebunden sind.Diese Schnittstelle ermöglicht es der Eigenschaft eines Objekts, um ein gebundenes Steuerelement zu benachrichtigen, dass die Eigenschaft geändert wurde, sodass das Steuerelement die aktualisierten Informationen anzeigen kann.Ohne das CallerMemberName-Attribut müssen Sie den Eigenschaftennamen als Literal angeben.

Das folgende Diagramm zeigt die Membernamen an, die zurückgegeben werden, wenn Sie das CallerMemberName-Attribut verwenden.

Siehe auch

Referenz

Attribute (C# und Visual Basic)

Konzepte

Allgemeine Attribute (C# und Visual Basic)

Optionale Parameter (Visual Basic)

Benannte und optionale Argumente (C#-Programmierhandbuch)

Weitere Ressourcen

Programmierungskonzepte