Что означает/*! */Mean в C#?

Question

Я новичок в C# и читаю код с /*!*/ в том, что кажется странным местом. Для методов экземпляра класса определяется как:

protected override OptionsParser/*!*/ CreateOptionsParser() 
protected override void ParseHostOptions(string/*!*/[]/*!*/ args) 

К сожалению /*!*/ не googleable. Что это значит?

Answer 1

Скорее всего, попытка получить аннотации SpeC# style к нестандартной конструкции #. ! аннотация в SpeC# означает, что значение не-null. Вероятно, автор пытается указать, что как возвращаемые значения, массив args, так и все элементы в args всегда являются ненулевыми значениями.

SpeC# Ссылка:

• http://research.microsoft.com/en-us/projects/specsharp/

Quick SpeC# Обзор:

SpeC# является .Net язык, созданный с помощью научно-исследовательского проекта Microsoft. Это расширение языка C#, которое пытается встраивать кодовые контракты в систему типов. Наиболее видными являются типы с недействительными (обозначаются символом! После имени типа), отмечены исключения и условия до/после.

Answer 2

Это комментарий, который содержит '!'

Все, что заключено в/* * /, является комментарием, который будет игнорироваться при компиляции кода.

Answer 3

/* is start comment 
*/ is end comment 

everything between is the comment 
you can even tell that SO highlights that area as a comment 

Answer 4

Это комментарий к '!'. Вероятно, программист хотел убедиться, что вы заметили, что первый метод возвратил OptionParser, а второй получил массив строк, а не только строку.

Вы можете удалить их, и они будут продолжать работать нормально =)

Answer 5

Это просто delimited comment; вероятно, ваш программист просто отметил, что пункты для обсуждения позже.

Answer 6

Как все говорили, это комментарий. Кроме того, мне кажется, что '!' используется для демаркации. Похоже, что он помогает выявлять интересующие вас предметы и служит для глазных конфет.

Answer 7

Я не знаю о C# специально, поскольку это может быть специальная нотация для чего-то, но я использую подобную технику на любом языке, который поддерживает токены с открытым/закрытым многострочным комментарием, чтобы я мог быстро комментировать и раскомментировать несколько строк с одним изменением характера, например:

/*!*/ 
this is live code (and will probably cause a compilation error) 
/*!*/ 

/*!*/
this is commented code (and should never cause a compilation error) 
/*!*/ 

причина ! потому, что конструкции, как /** общие маркеры, используемыми инструментами документирования.

Существуют и другие методы, а когда язык поддерживает однострочный комментарий лексем, // (и реализует их, как C++ и Java):

///* - opening comments can be commented-out so what follows isn't a comment. 
this is live code 
//*/ - closing comment are not commented-out by single-line comments. 

Таким образом, вы можете удалить первый однострочный комментарий маркер , //, для производства своего рода «переключателя»:

/* this is now commented. 
this is also commented. 
//*/ this line is live code.