【问题标题】:Invalid XML comment: invalid character无效的 XML 注释:无效字符
【发布时间】:2013-10-16 08:34:03
【问题描述】:
XML comment contains invalid XML: A name was started with an invalid character

这是我收到的 IntelliSense 文档消息。我的文档显然有问题,但我找不到。

    /// <summary>
    /// The local-part of an email adress may use any of these ASCII characters (As according to RFC 5322 <see href="http://tools.ietf.org/html/rfc5322"></see>):
    /// - Uppercase and lowercase English letters (a–z, A–Z) (ASCII: 65-90, 97-122)
    /// - Digits 0 to 9 (ASCII: 48-57)
    /// - Characters !#$%&'*+-/=?^_`{|}~ (ASCII: 33, 35-39, 42, 43, 45, 47, 61, 63, 94-96, 123-126)
    /// - Character . (dot, period, full stop) (ASCII: 46) provided that it is not the first or last character, and provided also that it does not appear two or more times consecutively (e.g. John..Doe@example.com is not allowed.)
    /// - Special characters are allowed with restrictions. They are: Space and "(),:;<>@[\] (ASCII: 32, 34, 40, 41, 44, 58, 59, 60, 62, 64, 91-93)
    /// - The restrictions for special characters are that they must only be used when contained between quotation marks, and that 3 of them (The space, backslash \ and quotation mark " (ASCII: 32, 92, 34)) must also be preceded by a backslash \ (e.g. "\ \\\"").
    /// </summary>

我的猜测是它与所有角色有关,但我真的不知道......

【问题讨论】:

    标签: c# xml documentation


    【解决方案1】:

    在这一行:

     /// - Special characters are allowed with restrictions. They are: Space and "(),:;<>@[\] (ASCII: 32, 34, 40, 41, 44, 58, 59, 60, 62, 64, 91-93)
    

    &amp;lt; 字符将被解释为 Xml 标签的开始(&amp;gt; 被解释为结束)。分别用&amp;lt;&amp;gt; 替换它们。您可能还需要使用&amp;amp; 转义其他字符,例如&amp;

    Here is a comprehensive list 的 Xml/Html 字符实体。

    【讨论】:

    • 谢谢,现在可以使用了!如果允许,我会在 2 分钟内接受它:)
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 2014-09-12
    • 2010-10-25
    • 2020-02-05
    • 2015-05-14
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多