C# Academy · 课时

源代码级信息（Caller 特性）

使用 CallerMemberName、CallerFilePath 和 CallerLineNumber 捕获调用位置的信息，用于日志、保护性检查和属性通知。

第 2 / 3 课8 个步骤

源代码级信息（Caller 特性） 是 CoddyKit 上的免费 C# Academy 课时。这是第 2 节课，共 3 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 3 节课。

为什么需要调用方信息

目标：自动捕获调用位置的信息。

CallerMemberName — 调用者是谁
CallerFilePath — 来自哪个文件
CallerLineNumber — 位于哪一行
非常适合用于日志、防护检查和通知

用于日志的成员名称

当省略参数时，CallerMemberName 会自动填入调用方的方法或属性名称。

using System;
using System.Runtime.CompilerServices;

public static class Log
{
  // Caller fills "member" automatically if not provided
  public static void Info(string msg, [CallerMemberName] string member = null)
  {
    Console.WriteLine("[" + (member ?? "?") + "] " + msg);
  }
}

public class Program
{
  static void DoWork() { Log.Info("started"); }

  public static void Main(string[] args)
  {
    Log.Info("app boot");
    DoWork(); // prints caller method name
  }
}

文件与行信息

添加 CallerFilePath 和 CallerLineNumber，以便精确定位诊断信息。

using System;
using System.Runtime.CompilerServices;

public static class Diag
{
  public static void Trace(string msg,
    [CallerFilePath] string file = null,
    [CallerLineNumber] int line = 0,
    [CallerMemberName] string member = null)
  {
    Console.WriteLine(file + ":" + line + " in " + member + " -> " + msg);
  }
}

public class Program
{
  static void Step() { Diag.Trace("stepping"); }

  public static void Main(string[] args)
  {
    Diag.Trace("start");
    Step();
  }
}

属性通知

在设置器或事件辅助方法中使用 CallerMemberName，避免硬编码字符串。

using System;
using System.Runtime.CompilerServices;

public class Person
{
  private string _name;

  // Notify helper uses CallerMemberName so callers need not pass the property name
  void Notify([CallerMemberName] string property = null)
  {
    Console.WriteLine("Changed: " + property);
  }

  public string Name
  {
    get { return _name; }
    set { _name = value; Notify(); } // property name auto-filled
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Person p = new Person();
    p.Name = "Ada"; // prints "Changed: Name"
  }
}

使用调用方名称进行防护检查

调用方信息可以让防护检查消息更加清晰，无需手动编写字符串。

using System;
using System.Runtime.CompilerServices;

public static class Guard
{
  public static void NotNull(object x, [CallerMemberName] string caller = null)
  {
    if (x == null) throw new ArgumentNullException("value", "Null passed by " + (caller ?? "?"));
  }
}

public class Program
{
  static void Save(string path)
  {
    Guard.NotNull(path); // if null, message includes "Save"
    Console.WriteLine("Saving to " + path);
  }

  public static void Main(string[] args)
  {
    try
    {
      Save(null);
    }
    catch (Exception ex)
    {
      Console.WriteLine(ex.Message);
    }
  }
}

提示与说明

说明：

调用方特性适用于带有默认值的可选参数。
不要将精确的文件路径用于保存机密信息；路径可能暴露文件夹结构。
非常适合用于日志记录、诊断和属性变更事件。

调用方名称特性

快速检查：哪个 attribute 可以让方法将调用者的名称作为默认参数值获取？

在交互式课程中回答

回顾

回顾：将 CallerMemberName、CallerFilePath 和 CallerLineNumber 添加到可选参数中，即可免费捕获调用方上下文。

免费开始

用 AI 导师学习 C# — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 93
课程: 346

免费开始学习查看完整课程

常见问题解答

「源代码级信息（Caller 特性）」课时是免费的吗？

是的 — 「源代码级信息（Caller 特性）」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 3 节课。

「源代码级信息（Caller 特性）」这节课中我会学到什么？

使用 CallerMemberName、CallerFilePath 和 CallerLineNumber 捕获调用位置的信息，用于日志、保护性检查和属性通知。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 3 节。

「源代码级信息（Caller 特性）」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy