属性使用 MSDN 指南说明

Question

我很难从 属性用法中找出此建议的含义指南：

不要定义同时具有命名参数和位置参数的参数。下面的代码示例说明了这种模式。

代码是：

public class NameAttribute: Attribute 
{
   string userName;
   int age;

   // This is a positional argument.
   public NameAttribute (string userName) 
   { 
       this.userName = userName;
   }
   public string UserName 
   { 
      get 
      {
         return userName; 
      }
   }
   // This is a named argument.
   public int Age 
   { 
      get 
      {
         return age;
      }
      set 
      {
         age = value;
      }
   } 
}

现在，如果它真的很简单，我很抱歉，我在浪费您的时间。但我只是不明白其含义和示例说明了什么。英语不是我的母语可能是一个因素，但我之前阅读 MSDN 并没有遇到任何困难。我也尝试阅读这篇文章的翻译版本，但它对我来说更没有意义。

因此，如果有人愿意重新措辞并向我解释它，那将非常有帮助。如果您还可以解释为什么 MSDN 建议这样做，我洗耳恭听。

Answer 1

考虑一下如何使用这样的属性：

[Name("Jack", Age = 25)]
public class ClassToDecorate { }

现在，这看起来不太清楚，因为两种样式混合在一起：UserName 是通过属性的构造函数（“位置”）设置的，但是 Age 被显式设置为属性（“named”）。

该指南建议最好重新设计该属性，以便完全以下装饰之一可以工作：（

[Name("Jack", 25)] // Positional only

或）

[Name(UserName = "Jack", Age = 25)] // Named only

Answer 2

我认为你是一个糟糕例子的受害者，它实际上并没有说明问题。错误的一个更好的例子是添加这个构造函数：

public NameAttribute (string userName, int age) 
{ 
    this.userName = userName;
    this.Age = age;
}

现在客户端代码可以这样使用属性：

[Name("foo", 42)]

和这样：

[Name("foo", Age = 42)]

两者同样有效，客户端程序员将无法弥补他的想法是选择哪一个。一个更糟糕的例子是这个构造函数：

public NameAttribute(int age) {
    this.userName = "unspecified";
    this.Age = age;
}

它允许：

[Name(42, Age = 43)]