Я надеюсь отображать это в моем .aspx
страница, не используя XML-тэги специального символа, это может быть достигнуто?
<asp:ServerTag Property1="a"
Property2="b"
Property3="c" <%-- Comment why this particular property is necessary --%>
Property4="d" />
Однако меня встречают сообщением об ошибке Server tags cannot contain <% ... %> constructs.
Если я использую HTML <!-> тег, мне говорят, что тег сервера не хорошо формируется.
Там какой-либо другой синтаксис должен сделать это возможным?
Это невозможно, нет. Серверные теги должны быть хорошо сформированным XML, а в XML нельзя иметь такие теги. Конечно, вы можете поместить комментарий сверху, например, так:
<!-- Property2 needed because... -->
<asp:ServerTag Property1="a" Property2="b" Property3="c" />
Не обязательно так, но вы можете рассмотреть вариант декорирования свойства в C #, чтобы пользователь знал о его релевантности. После этого что-то вроде resharper (или, возможно, vs) предоставит вам эту информацию, когда вы попытаетесь ее установить.
Поместите комментарий на стороне сервера над вашим серверным элементом управления .
комментарий на стороне клиента (html) - появляется в источнике html, но не отображается на странице
<% -
комментарий на стороне сервера - вырезан на сервере, никогда не видит света днем браузер никогда не знает об этом вот так
<%-- Usage:
Property2 is xyz...
Property3 will .. abc. Ignore Property 1 when this is set. etc
--%>
<asp:ServerTag Property1="a"
Property2="b"
Property3="c"
Property4="d" />
Это все равно, что помещать комментарии к исходному коду над вашими функциями.
Подумайте "от сервера к серверу". Это будет иметь значение между вашим исходным кодом HTML, который будет выглядеть
загроможденным с "сквозным" комментарием html :
Отображаемое содержимое серверного элемента управления.
vs. очиститель удалил " <% -
источник:
Отображение содержимого управления сервером.
Уменьшение пропускной способности при использовании последнего. Никаких посторонних (и сбивающих с толку пользователя) комментариев в Исходный код HTML.