{"id":1192,"date":"2012-11-30T22:09:26","date_gmt":"2012-11-30T22:09:26","guid":{"rendered":"http:\/\/nestor.nestasoft.fr\/?p=1192"},"modified":"2012-12-07T04:55:42","modified_gmt":"2012-12-07T04:55:42","slug":"c-5-les-attributs-dinformations-de-lappelant-caller-info-attributes","status":"publish","type":"post","link":"https:\/\/nestasoft.fr\/?p=1192","title":{"rendered":"C# 5 : Les attributs d&rsquo;informations de l&rsquo;appelant (Caller Info attributes)"},"content":{"rendered":"<p>L\u2019une des nouvelles fonctionnalit\u00e9 de C# 5 sont les attributs d\u2019informations de l\u2019appelant. <\/p>\n<p>Ces attributs sont en fait trois attributs (CallerMemberName, CallerFilePath, CallerLineNumber) des trois classes(CallerMemberNameAttribute, CallerFilePathAttribute,&#160; CallerLineNumberAttribute) que l\u2019on peut utiliser dans les arguments des m\u00e9thodes, afin d\u2019obtenir plus d\u2019informations sur l\u2019\u00e9l\u00e9ment appelant. Avec ces trois attributs, l\u2019on peut ainsi r\u00e9cup\u00e9rer le nom du fichier source qui a appel\u00e9, le num\u00e9ro de ligne dans ce fichier et le nom de l\u2019\u00e9l\u00e9ment appelant.<\/p>\n<p>Petit r\u00e9sum\u00e9 :<\/p>\n<ul>\n<li>CallerMemberName: Retourne le nom du fichier code source de l\u2019appelant.<\/li>\n<li>CallerFilePath: Retourne le num\u00e9ro de ligne du fichier code de l\u2019appelant.<\/li>\n<li>CallerLineNumber: Retourne le nom de l\u2019\u00e9l\u00e9ment appelant.<\/li>\n<\/ul>\n<p>Avant d\u2019entre dans le vif du sujet pour une d\u00e9monstration, il est important de comprendre le fonctionnement des param\u00e8tres optionnels.<\/p>\n<p><font color=\"#c0504d\" size=\"2\"><strong>Param\u00e8tres optionnels<\/strong><\/font><\/p>\n<p>Les param\u00e8tres optionnels ont vu le jour avec la sortie de C# 4. <\/p>\n<p>Chaque param\u00e8tre optionnel est associ\u00e9 \u00e0 une valeur par d\u00e9faut dans le cadre de sa d\u00e9finition. Si aucun argument n&rsquo;est envoy\u00e9 pour ce param\u00e8tre, la valeur par d\u00e9faut est utilis\u00e9e.<\/p>\n<p>La bonne utilisation des param\u00e8tres optionnels, r\u00e9duit de fa\u00e7on significative l\u2019usage des surcharges des m\u00e9thodes.<\/p>\n<p><strong>Exemple<\/strong> <strong>de surcharge de m\u00e9thodes<\/strong> : <\/p>\n<pre class=\"brush:csharp\"> \r\npublic void  Display(string nom, int age,string pays)\r\n{\r\n    Console.WriteLine(&quot;Nom : &quot; + nom);\r\n    Console.WriteLine(&quot;\u00c2ge : &quot; + age);\r\n    Console.WriteLine(&quot;Pays : &quot; + pays);\r\n}\r\n\r\npublic void Display(string nom, string prenom, int age, string sexe)\r\n{\r\n    Console.WriteLine(&quot;Nom : &quot; + nom);\r\n    Console.WriteLine(&quot;Pr\u00e9nom : &quot; + prenom);\r\n    Console.WriteLine(&quot;\u00c2ge : &quot; + age);\r\n}<\/pre>\n<p>Depuis la sortie de C# 4, se serait un g\u00e2chis de coder de cette fa\u00e7on. Le code ci-dessus deviendrai : <\/p>\n<pre class=\"brush:csharp\"> \r\npublic void Display(string nom, string prenom, string age, string sexe = &quot;Masculin&quot;, string pays = &quot;Canada&quot;)\r\n{\r\n    Console.WriteLine(&quot;============================================================&quot;);\r\n    Console.WriteLine(&quot;Les attributs optionnels&quot;);\r\n    Console.WriteLine(&quot;============================================================&quot;);\r\n    Console.WriteLine(&quot;Nom : &quot; + nom);\r\n    Console.WriteLine(&quot;Pr\u00e9nom : &quot; + prenom);\r\n    Console.WriteLine(&quot;\u00c2ge : &quot; + age);\r\n    Console.WriteLine(&quot;Sexe : &quot; + sexe);\r\n    Console.WriteLine(&quot;Pays : &quot; + pays);\r\n}<\/pre>\n<p>&#160;<\/p>\n<p>Ex\u00e9cutons notre classe : <\/p>\n<pre class=\"brush:csharp\"> \r\npublic class Program\r\n{\r\n   static void Main(string[] args)\r\n   {\r\n      new ParametresOptionnels().Display(&quot;K&quot;, &quot;Nestor Aim\u00e9&quot;, 15, &quot;Masculin&quot; );\r\n   }\r\n}<\/pre>\n<p>&#160;<\/p>\n<p>R\u00e9sultat : <\/p>\n<p><a href=\"http:\/\/nestor.nestasoft.fr\/wp-content\/uploads\/2012\/11\/CallerInformation1.PNG\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter\" style=\"border-left-width: 0px; border-right-width: 0px; background-image: none; border-bottom-width: 0px; float: none; padding-top: 0px; padding-left: 0px; margin: 0px auto; display: block; padding-right: 0px; border-top-width: 0px\" border=\"0\" src=\"http:\/\/nestor.nestasoft.fr\/wp-content\/uploads\/2012\/11\/CallerInformation1.PNG\" width=\"600\" height=\"118\" \/><\/a><\/p>\n<p>Dans cet exemple, l\u2019on constate que l\u2019un des param\u00e8tres optionnels (pays) a pris la valeur par d\u00e9faut (\u201cCanada\u201d).<\/p>\n<p>&#160;<\/p>\n<p><font color=\"#c0504d\" size=\"2\"><strong>Les attributs d\u2019informations de l\u2019appelant (Caller Info Attributes)<\/strong><\/font><\/p>\n<p>Comme mentionn\u00e9 au d\u00e9but de ce billet, avec C# 5, nous pouvons d\u00e9sormais utiliser certains attributs (<strong>CallerMemberName<\/strong>, <strong>CallerFilePath<\/strong>, <strong>CallerLineNumber<\/strong>) pour obtenir de l\u2019information sur l\u2019appelant. Ces trois attributs peuvent s\u2019av\u00e9rer tr\u00e8s efficace lors du d\u00e9veloppement des solutions de logs et de diagnostiques. Ces attributs sont d\u00e9finis dans l\u2019espace de nom <strong>System.Runtime.CompilerServices<\/strong>.<\/p>\n<p><strong>D\u00e9mo<\/strong> : <\/p>\n<pre class=\"brush:csharp\"> \r\npublic class CallerInfoAttributes\r\n{\r\n   public void Display(string nom, string prenom, int age, string sexe = &quot;Masculin&quot;, string nationalite = &quot;Canadien&quot;,\r\n  [CallerMemberName] string appelant = &quot;&quot;,\r\n  [CallerFilePath] string fichier = &quot;&quot;,\r\n  [CallerLineNumber] int noLigne = 0)\r\n  {\r\n      Console.WriteLine(&quot;============================================================&quot;);\r\n      Console.WriteLine(&quot;Les attributs d'informations de l'appelant&quot;);\r\n      Console.WriteLine(&quot;============================================================&quot;);\r\n      Console.WriteLine(&quot;Bonjour &quot; + prenom + &quot; &quot; + nom + &quot;, vous avez &quot; + age + &quot; ans &quot; + &quot; et \u00eates de nationalit\u00e9 &quot; + nationalite);\r\n      Console.WriteLine(&quot;Cette m\u00e9thode est appel\u00e9e dans la m\u00e9thode: &quot; + appelant + &quot;, du fichier &quot; + fichier + &quot;, \u00e0 la ligne &quot; + noLigne);\r\n  }\r\n}\r\n\r\nstatic void Main(string[] args)\r\n{\r\n   new ParametresOptionnels().Display(&quot;K&quot;, &quot;Nestor Aim\u00e9&quot;, 15, &quot;Masculin&quot;);\r\n   new CallerInfoAttributes().Display(&quot;K&quot;, &quot;Nestor Aim\u00e9&quot;, 15, &quot;Masculin&quot;);\r\n}<\/pre>\n<p>&#160;<\/p>\n<p>R\u00e9sultat :<\/p>\n<p><a href=\"http:\/\/nestor.nestasoft.fr\/wp-content\/uploads\/2012\/11\/CallerInformation2.PNG\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter\" style=\"border-left-width: 0px; border-right-width: 0px; background-image: none; border-bottom-width: 0px; float: none; padding-top: 0px; padding-left: 0px; margin: 0px auto; display: block; padding-right: 0px; border-top-width: 0px\" border=\"0\" src=\"http:\/\/nestor.nestasoft.fr\/wp-content\/uploads\/2012\/11\/CallerInformation2.PNG\" width=\"600\" height=\"257\" \/><\/a><\/p>\n<p>&#160;<\/p>\n<p>N\u2019est ce pas merveilleux!<\/p>\n<p>Quelques d\u00e9tails de la d\u00e9mo: <\/p>\n<p>CallerMemberName : permet de r\u00e9cup\u00e9rer le nom du membre ayant appel\u00e9 la m\u00e9thode Display. Ici l\u2019\u00ab \u00e9l\u00e9ment \u00bb est une m\u00e9thode (Dans certains cas l\u2019\u00e9l\u00e9ment peut -\u00eatre une propri\u00e9t\u00e9, un constructeur ou encore un destructeur).<\/p>\n<p>CallerFilePath : permet de r\u00e9cup\u00e9rer le nom du fichier code source d\u2019o\u00f9 provient l\u2019appel (<strong>Main<\/strong>).<\/p>\n<p>CallerLineNumber : permet de r\u00e9cup\u00e9rer la ligne du fichier code source d\u2019o\u00f9 provient l\u2019appel (<strong>14<\/strong>).<\/p>\n<p>Bon \u00e0 savoir : L\u2019attribut <strong>CallerMemberName&#160; <\/strong>impl\u00e9mente l\u2019interface INotifyPropertyChanged.<\/p>\n<p>&#160;<\/p>\n<p>Be connected!<\/p>\n<div class=\"pvc_clear\"><\/div>\n<p id=\"pvc_stats_1192\" class=\"pvc_stats all  \" data-element-id=\"1192\" style=\"\"><i class=\"pvc-stats-icon medium\" aria-hidden=\"true\"><svg aria-hidden=\"true\" focusable=\"false\" data-prefix=\"far\" data-icon=\"chart-bar\" role=\"img\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 512 512\" class=\"svg-inline--fa fa-chart-bar fa-w-16 fa-2x\"><path fill=\"currentColor\" d=\"M396.8 352h22.4c6.4 0 12.8-6.4 12.8-12.8V108.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v230.4c0 6.4 6.4 12.8 12.8 12.8zm-192 0h22.4c6.4 0 12.8-6.4 12.8-12.8V140.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v198.4c0 6.4 6.4 12.8 12.8 12.8zm96 0h22.4c6.4 0 12.8-6.4 12.8-12.8V204.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v134.4c0 6.4 6.4 12.8 12.8 12.8zM496 400H48V80c0-8.84-7.16-16-16-16H16C7.16 64 0 71.16 0 80v336c0 17.67 14.33 32 32 32h464c8.84 0 16-7.16 16-16v-16c0-8.84-7.16-16-16-16zm-387.2-48h22.4c6.4 0 12.8-6.4 12.8-12.8v-70.4c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v70.4c0 6.4 6.4 12.8 12.8 12.8z\" class=\"\"><\/path><\/svg><\/i> <img loading=\"lazy\" decoding=\"async\" width=\"16\" height=\"16\" alt=\"Loading\" src=\"https:\/\/nestasoft.fr\/wp-content\/plugins\/page-views-count\/ajax-loader-2x.gif\" border=0 \/><\/p>\n<div class=\"pvc_clear\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>L\u2019une des nouvelles fonctionnalit\u00e9 de C# 5 sont les attributs d\u2019informations de l\u2019appelant. Ces attributs sont en fait trois attributs (CallerMemberName, CallerFilePath, CallerLineNumber) des trois classes(CallerMemberNameAttribute, CallerFilePathAttribute,&#160; CallerLineNumberAttribute) que l\u2019on peut utiliser dans les arguments des m\u00e9thodes, afin d\u2019obtenir plus d\u2019informations sur l\u2019\u00e9l\u00e9ment appelant. Avec ces trois attributs, l\u2019on peut ainsi r\u00e9cup\u00e9rer le nom du [&hellip;]<\/p>\n<div class=\"pvc_clear\"><\/div>\n<p id=\"pvc_stats_1192\" class=\"pvc_stats all  \" data-element-id=\"1192\" style=\"\"><i class=\"pvc-stats-icon medium\" aria-hidden=\"true\"><svg aria-hidden=\"true\" focusable=\"false\" data-prefix=\"far\" data-icon=\"chart-bar\" role=\"img\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 512 512\" class=\"svg-inline--fa fa-chart-bar fa-w-16 fa-2x\"><path fill=\"currentColor\" d=\"M396.8 352h22.4c6.4 0 12.8-6.4 12.8-12.8V108.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v230.4c0 6.4 6.4 12.8 12.8 12.8zm-192 0h22.4c6.4 0 12.8-6.4 12.8-12.8V140.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v198.4c0 6.4 6.4 12.8 12.8 12.8zm96 0h22.4c6.4 0 12.8-6.4 12.8-12.8V204.8c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v134.4c0 6.4 6.4 12.8 12.8 12.8zM496 400H48V80c0-8.84-7.16-16-16-16H16C7.16 64 0 71.16 0 80v336c0 17.67 14.33 32 32 32h464c8.84 0 16-7.16 16-16v-16c0-8.84-7.16-16-16-16zm-387.2-48h22.4c6.4 0 12.8-6.4 12.8-12.8v-70.4c0-6.4-6.4-12.8-12.8-12.8h-22.4c-6.4 0-12.8 6.4-12.8 12.8v70.4c0 6.4 6.4 12.8 12.8 12.8z\" class=\"\"><\/path><\/svg><\/i> <img loading=\"lazy\" decoding=\"async\" width=\"16\" height=\"16\" alt=\"Loading\" src=\"https:\/\/nestasoft.fr\/wp-content\/plugins\/page-views-count\/ajax-loader-2x.gif\" border=0 \/><\/p>\n<div class=\"pvc_clear\"><\/div>\n","protected":false},"author":1,"featured_media":1196,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-1192","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/posts\/1192","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1192"}],"version-history":[{"count":10,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/posts\/1192\/revisions"}],"predecessor-version":[{"id":1219,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/posts\/1192\/revisions\/1219"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=\/wp\/v2\/media\/1196"}],"wp:attachment":[{"href":"https:\/\/nestasoft.fr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1192"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1192"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nestasoft.fr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1192"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}