Предупреждения пользовательского компилятора

Обновлять

Теперь это возможно с Roslyn (Visual Studio 2015). Вы можете создать анализатор кода для проверки наличия настраиваемого атрибута.

Я не верю, что это возможно. ObsoleteAttribute обрабатывается компилятором особым образом и определен в стандарте C #. Почему, черт возьми, ObsoleteAttribute неприемлемо? Мне кажется, что это именно та ситуация, для которой он был разработан, и позволяет достичь именно того, что вам нужно!

Также обратите внимание, что Visual Studio также на лету принимает предупреждения, генерируемые ObsoleteAttribute, что очень полезно.

Не хочу быть бесполезным, просто интересно, почему вы не хотите его использовать ...

К сожалению, ObsoleteAttribute запечатан (вероятно, отчасти из-за особой обработки), поэтому вы не можете создать на его основе свой собственный атрибут.

Из стандарта C #: -

Атрибут Obsolete используется для обозначения типов и членов типов, которые больше не должны использоваться.

Если программа использует тип или член, украшенный атрибутом Obsolete, компилятор выдает предупреждение или ошибку. В частности, компилятор выдает предупреждение, если не указан параметр ошибки или если параметр ошибки указан и имеет значение false. Компилятор выдает ошибку, если параметр ошибки указан и имеет значение true.

Разве это не подводит итог твоим потребностям? ... я не думаю, что ты добьешься большего успеха, чем это.

Стоит попробовать.

Вы не можете расширить Obsolete, потому что он окончательный, но, возможно, вы можете создать свой собственный атрибут и пометить этот класс как устаревший следующим образом:

[Obsolete("Should be refactored")]
public class MustRefactor: System.Attribute{}

Затем, когда вы помечаете свои методы атрибутом «MustRefactor», будут отображаться предупреждения компиляции. Он генерирует предупреждение во время компиляции, но сообщение об ошибке выглядит забавно, вы должны увидеть его сами и выбрать. Это очень близко к тому, чего вы хотели достичь.

ОБНОВЛЕНИЕ: с помощью этого кода выдается предупреждение (не очень хорошо, но я не думаю, что есть что-нибудь получше).

public class User
{
    private String userName;

    [TooManyArgs] // Will show warning: Try removing some arguments
    public User(String userName)
    {
        this.userName = userName;   
    }

    public String UserName
    {
        get { return userName; }
    }
    [MustRefactor] // will show warning: Refactor is needed Here
    public override string ToString()
    {
        return "User: " + userName;
    }
}
[Obsolete("Refactor is needed Here")]
public class MustRefactor : System.Attribute
{

}
[Obsolete("Try removing some arguments")]
public class TooManyArgs : System.Attribute
{

}

В некоторых компиляторах вы можете использовать #warning для вывода предупреждения:

#warning "Do not use ABC, which is deprecated. Use XYZ instead."

В компиляторах Microsoft вы обычно можете использовать прагму message:

#pragma message ( "text" )

Вы упомянули .Net, но не указали, программируете ли вы на C / C ++ или C #. Если вы программируете на C #, то должны знать, что C # поддерживает формат #warning.

Сейчас мы находимся в процессе рефакторинга, из-за которого мы не могли исправить все сразу. Мы просто используем команду #warning preproc, где нам нужно вернуться и посмотреть код. Он отображается в выводе компилятора. Я не думаю, что вы можете поместить это в метод, но вы можете поместить его просто внутри метода, и его все равно легко найти.

public void DoEverything() {
   #warning "This code sucks"
}

В VS 2008 (+ sp1) # предупреждения не отображаются должным образом в списке ошибок после Clean Soultion & Rebuild Solution, не все из них. Некоторые предупреждения отображаются в списке ошибок только после того, как я открываю определенный файл класса. Поэтому я был вынужден использовать настраиваемый атрибут:

[Obsolete("Mapping ToDo")]
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Property)]
public class MappingToDo : System.Attribute
{
    public string Comment = "";

    public MappingToDo(string comment)
    {
        Comment = comment;
    }

    public MappingToDo()
    {}
}

Поэтому, когда я помечаю им какой-то код

[MappingToDo("Some comment")]
public class MembershipHour : Entity
{
    // .....
}

Он выдает такие предупреждения:

Namespace.MappingToDo устарел: «Mapping ToDo».

Я не могу изменить текст предупреждения, «Некоторые комментарии» не отображаются в списке ошибок. Но он переместится в нужное место в файле. Поэтому, если вам нужно изменить такие предупреждающие сообщения, создайте различные атрибуты.

Вы пытаетесь неправильно использовать атрибуты. Вместо этого используйте список задач Visual Studio. Вы можете ввести комментарий в свой код следующим образом:

//TODO:  This code sux and should be looked at
public class SuckyClass(){
  //TODO:  Do something really sucky here!
}

Затем откройте в меню Просмотр / Список задач. В списке задач есть две категории: задачи пользователя и комментарии. Переключитесь на Комментарии, и вы увидите все свои // Todo: там. Двойной щелчок по TODO приведет к переходу к комментарию в вашем коде.

Al

Я не думаю, что ты сможешь. Насколько мне известно, поддержка ObsoleteAttribute по существу жестко встроена в компилятор C #; вы не можете делать ничего подобного напрямую.

Что вы можете сделать, так это использовать задачу MSBuild (или событие после сборки), которое запускает настраиваемый инструмент для только что скомпилированной сборки. Пользовательский инструмент будет отражать все типы / методы в сборке и использовать ваш настраиваемый атрибут, после чего он может печатать в System.Console по умолчанию или в TextWriters с ошибкой.

Глядя на источник ObsoleteAttribute, он не выглядит как будто он делает что-то особенное для генерации предупреждения компилятора, поэтому я бы предпочел @ технофил и говорят, что это жестко запрограммировано в компиляторе. Есть ли причина, по которой вы не хотите просто использовать ObsoleteAttribute генерировать ваши предупреждающие сообщения?

Есть несколько комментариев, предлагающих вставить предупреждения или прагму. Устаревшее работает совсем по-другому! Отмечая устаревшую функцию библиотеки L, сообщение об устаревшем появляется, когда программа вызывает функцию, даже если вызывающая программа не находится в библиотеке L. Предупреждение вызывает сообщение ТОЛЬКО при компиляции L.

Вот реализация Roslyn, поэтому вы можете создавать свои собственные атрибуты, которые выдают предупреждения или ошибки на лету.

Я создал атрибут Type Called IdeMessage, который будет атрибутом, который генерирует предупреждения:

[AttributeUsage(AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
public class IDEMessageAttribute : Attribute
{
    public string Message;

    public IDEMessageAttribute(string message);
}

Для этого вам необходимо сначала установить Roslyn SDK и запустить новый проект VSIX с анализатором. Я пропустил некоторые менее важные части, такие как сообщения, вы можете понять, как это сделать. В вашем анализаторе вы делаете это

public override void Initialize(AnalysisContext context)
{
    context.RegisterSyntaxNodeAction(AnalyzerInvocation, SyntaxKind.InvocationExpression);
}

private static void AnalyzerInvocation(SyntaxNodeAnalysisContext context)
{
    var invocation = (InvocationExpressionSyntax)context.Node;

    var methodDeclaration = (context.SemanticModel.GetSymbolInfo(invocation, context.CancellationToken).Symbol as IMethodSymbol);

    //There are several reason why this may be null e.g invoking a delegate
    if (null == methodDeclaration)
    {
        return;
    }

    var methodAttributes = methodDeclaration.GetAttributes();
    var attributeData = methodAttributes.FirstOrDefault(attr => IsIDEMessageAttribute(context.SemanticModel, attr, typeof(IDEMessageAttribute)));
    if(null == attributeData)
    {
        return;
    }

    var message = GetMessage(attributeData); 
    var diagnostic = Diagnostic.Create(Rule, invocation.GetLocation(), methodDeclaration.Name, message);
    context.ReportDiagnostic(diagnostic);
}

static bool IsIDEMessageAttribute(SemanticModel semanticModel, AttributeData attribute, Type desiredAttributeType)
{
    var desiredTypeNamedSymbol = semanticModel.Compilation.GetTypeByMetadataName(desiredAttributeType.FullName);

    var result = attribute.AttributeClass.Equals(desiredTypeNamedSymbol);
    return result;
}

static string GetMessage(AttributeData attribute)
{
    if (attribute.ConstructorArguments.Length < 1)
    {
        return "This method is obsolete";
    }

    return (attribute.ConstructorArguments[0].Value as string);
}

Для этого нет CodeFixProvider, вы можете удалить его из решения.