总结，形成了严重的忽视了成员XML注释 [英] Summary, badly formed XML comment ignored for member

问题描述

我记录在VS 2010中我班成员摘要属性。当我建项目的XML文件是建立（我将在以后开发使用）。一类成员的总结不包括在XML文件中，忽略成员错误的XML注释，而不是出现错误。

摘要为text如下。我不明白的格式不正确。我应该逃避&安培; 字符，并使用 26％呢？

  ///<总结> 
 ///网页的URI来进行转换。必须以http：//或https：//。网页的多个URI可以被传递以创建一个PDF。例如，如果HTTP：//www.google.com+http：//www.nytimes.com URI将通过这两个网页将被合并成一个PDF文件。 
 ///如果URI包含特殊字符，如？或放大器;它们必须被编码。 
 ///< /总结> 
  

解决方案

由于它是你必须特殊字符进行编码XML。你的&安培; 号（以前咬伤我）需要用&放大器更换;放大器; 。

I am documenting my class members in VS 2010 with Summary attribute. When I build project the XML file is build(I will use it later in developing). One of class member's summary is not included in XML file, instead error appears "Badly formed XML comment ignored for member".

The summary is text is below. I do not understand what is formatted incorrectly. Should I escape & character and use %26 instead?

    /// <summary>
    /// URI of a web page to convert. Must start with http:// or https://. Several URI of web pages can be passed to create one PDF. For example if http://www.google.com+http://www.nytimes.com URI will be passed the two web pages will be merged into one PDF.
    /// If URI has special characters like ? or & they must be encoded.
    /// </summary>

解决方案

Since it's XML you have to encode special characters. Your & sign (has bitten me before) needs to be replaced with &.

这篇关于总结，形成了严重的忽视了成员XML注释的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！