我正在尝试定义一个结构,该结构使用具有受限制的数字范围的变量,以及来自整数的隐式强制。如果在此结构中使用任何常量或其他硬编码值,我希望能够强制构建错误。
这是我想要完成的一个例子。
byte a = 123; // Allowed
byte b = 123123; // Not allowed
const int x = 123;
const int y = 123123;
byte c = x; // Allowed
byte d = y; // Not allowed
理想情况下,我希望能够将数字限制在1到99之间,以便MyStruct s = 50;但是MyStruct s = 150;导致编译时错误,如上面的字节b和d。
我找到了something similar for a different language,但没有找到C#。
答案 0 :(得分:1)
我认为您可以通过使用自定义属性和roslyn代码分析来实现此目的。让我勾勒一个解决方案。这应该至少解决用文字初始化的第一个用例。
首先,您需要一个适用于您的结构的自定义属性,以允许代码分析能够知道有效范围:
[AttributeUsage(System.AttributeTargets.Struct)]
public class MinMaxSizeAttribute : Attribute
{
public int MinVal { get; set;}
public int MaxVal { get; set;}
public MinMaxSizeAttribute()
{
}
}
您在此处执行的操作是将最小值和最大值存储在属性中。这样,您可以稍后在源代码分析中使用它。
现在将此属性应用于struct声明:
[MinMaxSize(MinVal = 0, MaxVal = 100)]
public struct Foo
{
//members and implicit conversion operators go here
}
现在struct Foo
的类型信息包含值范围。接下来您需要DiagnosticAnalyzer
来分析您的代码。
public class MyAnalyzer : DiagnosticAnalyzer
{
internal static DiagnosticDescriptor Rule = new DiagnosticDescriptor("CS00042",
"Value not allowed here",
@"Type {0} does not allow Values in this range",
"type checker",
DiagnosticSeverity.Error,
isEnabledByDefault: true, description: "Value to big");
public MyAnalyzer()
{
}
#region implemented abstract members of DiagnosticAnalyzer
public override void Initialize(AnalysisContext context)
{
context.RegisterSyntaxNodeAction(AnalyzeSyntaxTree, SyntaxKind.SimpleAssignmentExpression);
}
public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics => ImmutableArray.Create(Rule);
#endregion
private static void AnalyzeSyntaxTree(SyntaxNodeAnalysisContext context)
{
}
}
这是参与代码分析的裸骨架。分析仪注册以分析分配:
context.RegisterSyntaxNodeAction(AnalyzeSyntaxTree, SyntaxKind.SimpleAssignmentExpression);
对于变量声明,您需要注册一个不同的SyntaxKind
,但为了简单起见,我将在这里坚持一个。
让我们看一下分析逻辑:
private static void AnalyzeSyntaxTree(SyntaxNodeAnalysisContext context)
{
if (context.Node.IsKind(SyntaxKind.SimpleAssignmentExpression))
{
var assign = (AssignmentExpressionSyntax)context.Node;
var leftType = context.SemanticModel.GetTypeInfo(assign.Left).GetType();
var attr = leftType.GetCustomAttributes(typeof(MinMaxSizeAttribute), false).OfType<MinMaxSizeAttribute>().FirstOrDefault();
if (attr != null && assign.Right.IsKind(SyntaxKind.NumericLiteralExpression))
{
var numLitteral = (LiteralExpressionSyntax)assign.Right;
var t = numLitteral.Token;
if (t.Value.GetType().Equals(typeof(int)))
{
var intVal = (int)t.Value;
if (intVal > attr.MaxVal || intVal < attr.MaxVal)
{
Diagnostic.Create(Rule, assign.GetLocation(), leftType.Name);
}
}
}
}
}
分析器的作用是检查左侧的类型是否与MinMaxSize
相关联,如果是,则检查右侧是否为文字。当它是文字时,它会尝试获取整数值,并将其与与该类型相关联的MinVal
和MaxVal
进行比较。如果值超出该范围,则会报告诊断错误。
请注意,所有这些代码大多未经测试。它编译并通过了一些基本测试。但它只是为了说明一个可能的解决方案。有关详细信息,请查看Rsolyn Docs
您希望涵盖的第二种情况更为复杂,因为您需要应用dataflow analyzes来获取x
的值。