Mit Caller Info Attributes können Informationen über den Aufrufer an eine Methode abgerufen werden. Man erhält Dateipfad des Quellcodes, Zeilennummer im Quellcode und Name des Aufrufers. Diese Informationen sind für das Debuggen, die Ablaufverfolgung und das Erstellen von Diagnosetools hilfreich.
Die folgenden Attribute sind verfügbar:
Aufruferinformationen in C# 5
| Attribut | Beschreibung | Type |
|---|---|---|
| CallerMemberName | Methode oder Eigenschaftenname des Aufrufers. | String |
| CallerFilePathAttribute | Vollständiger Pfad der Quelldatei, die den Aufrufer enthält. Dies ist der Dateipfad zur Kompilierzeit. | String |
| CallerLineNumberAttribute | Zeilennummer in der Quelldatei ab, in der die Methode aufgerufen wird. | Integer |
Nachfolgend ein kleines Beispielprogramm:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
using System; using System.Runtime.CompilerServices; namespace CallerInfoSample { class Program { static void Main() { GetCallerInfo(); Console.ReadKey(); } static void GetCallerInfo([CallerMemberName] string callerMemberName = null, [CallerFilePath] string callerFilePath = null, [CallerLineNumber] int callerLineNumber = -1) { Console.WriteLine("Caller Name: {0}", callerMemberName); Console.WriteLine("Caller FilePath: {0}", callerFilePath); Console.WriteLine("Caller LineNumber: {0}", callerLineNumber); } } } |
Output des oben gezeigten Programs:
Hier nun ein praktisches Beispiel für die Verwendung des CallerMemberName-Attributes. Wer schon einmal mit WPF programmiert hat, kennt das Interface INotifyPropertyChanged. Dies ist innerhalb der WPF-Programmierung ein allgegenwärtiges Interface, mit dem Änderungen z.B. von einem ViewModel zu einem daran gebunden UI Element propagiert werden. Eine typische Implementierung von INotifyPropertyChanged sieht etwa so aus:
Problem: Die EventArgs für das PropertyChanged-Event bekommen als Parameter einen String, der dem Namen der Property entspricht. Das bringt das Problem von Verschreibern mit sich und auch beim Umbenennen von Eigenschaften kann leicht vergessen werden den Namen beim Aufruf der OnPropertyChanged-Methode anzupassen. Hier kommt jetzt das CallerMemberName-Attribut zum Einsatz:
Durch die Verwendung des CallerMemberName-Attributes muss der Property-Name nun nicht mehr angegeben werden! Somit ist das Risiko von Verschreibern eliminiert und auch das Umbennen von Eigenschaften ist kein Problem mehr! Somit ist der Code wartungsfreundlicher und „robuster“.
Login