入门级问题——给WebMethod方法添加参数描述

时间:2021-07-01 00:28:35

        /// <summary>
        /// 根据用户所进入的系统名称和用户IDCode返回该用户的基本信息
        /// </summary>
        /// <param name="IDCode">登录人员的域账户</param>
        /// <param name="SysName">登录系统名称(注:应与MemberManager系统中的系统名称一致)</param>
        /// <param name="Mark">0:该成员无进入系统权限  1:可以进入该系统 2:该系统现在已经停止使用 3:该成员现在无进入权限了</param>
        /// <returns></returns>
        [WebMethod]
        public DataTable GetMemberBase(string IDCode, string SysName, out int Mark)
        {
            DataTable result = null;
            Mark = 0;
            return result;
        } 

类似出现下面这种描述  肿么写
http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx;


getSupportCityDataset 


获得支持的城市/地区名称和与之对应的ID
输入参数:theRegionCode = 省市、国家ID或名称,返回数据:DataSet。




13 个解决方案

#1



        [WebMethod(Description = "根据用户所进入的系统名称和用户IDCode返回该用户的基本信息")]
        public DataTable GetMemberBase(string IDCode, string SysName, out int Mark)
        {
            DataTable result = null;
            Mark = 0;
            return result;
        }  

这样只能给这个方法一个整体的描述 想给每个参数都有描述  返回值也给描述 
求写法

#3


引用 2 楼 fangxinggood 的回复:
http://*.com/questions/1160571/describing-asmx-web-service-webmethod-parameters
只看到问题没看到answer啊

#4


引用 2 楼 fangxinggood 的回复:
http://*.com/questions/1160571/describing-asmx-web-service-webmethod-parameters
参数和返回值都给描述 就像这个 http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx

#5


By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlHelpGenerator 配置一个 HelpGenerator.aspx 去形成帮助文档。
因为 .net 自带的这个功能有限。

#6


引用 5 楼 fangxinggood 的回复:
By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlH……
3q  我试试

#7


引用 5 楼 fangxinggood 的回复:
By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlH……
哇哦 这个不会是要自己全部重新搞吧…… 能出现自己定制说明的页子 但每个方法的说明就不管用了……

#9


引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……

#10


引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
过去了 看来需要研究的东西太多了 受教了  还是不知道要把这些描述放到哪……

#11


引用 9 楼 yanbuodiao 的回复:
引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。

#12


引用 11 楼 fangxinggood 的回复:
引用 9 楼 yanbuodiao 的回复:

引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。
打开是个空白页面……  我在看看

#13


引用 11 楼 fangxinggood 的回复:
引用 9 楼 yanbuodiao 的回复:

引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。

嘿嘿 用比较麻烦的手段解决了  您说的那个方法随后研究

 [WebMethod(Description = @"<h3>根据用户所进入的系统名称和用户IDCode返回该用户的基本信息</h3>
                                     <div>
                                        <h4>
                                            输入参数:</h4>
                                        IDCode:登录人员的域账户<br />
                                        SysName:登录系统名称(注:应与MemberManager系统中的系统名称一致)<br />
                                        Mark:0:该成员无进入系统权限 1:可以进入该系统 2:该系统现在已经停止使用 3:该成员现在无进入权限了<br />
                                    </div>")]
        public DataTable GetMemberBase(string IDCode, string SysName, out int Mark)
        {
            DataTable result = null;
            Mark = 0;
            return result;
        }
就是写死点html的东东

#1



        [WebMethod(Description = "根据用户所进入的系统名称和用户IDCode返回该用户的基本信息")]
        public DataTable GetMemberBase(string IDCode, string SysName, out int Mark)
        {
            DataTable result = null;
            Mark = 0;
            return result;
        }  

这样只能给这个方法一个整体的描述 想给每个参数都有描述  返回值也给描述 
求写法

#2


#3


引用 2 楼 fangxinggood 的回复:
http://*.com/questions/1160571/describing-asmx-web-service-webmethod-parameters
只看到问题没看到answer啊

#4


引用 2 楼 fangxinggood 的回复:
http://*.com/questions/1160571/describing-asmx-web-service-webmethod-parameters
参数和返回值都给描述 就像这个 http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx

#5


By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlHelpGenerator 配置一个 HelpGenerator.aspx 去形成帮助文档。
因为 .net 自带的这个功能有限。

#6


引用 5 楼 fangxinggood 的回复:
By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlH……
3q  我试试

#7


引用 5 楼 fangxinggood 的回复:
By default DefaultWsdlHelpGenerator.aspx is called to generate the "help" page. You can set another (or modified) template with the wsdlHelpGenerator Element in your web.config file.

它的意思是说通过 wsdlH……
哇哦 这个不会是要自己全部重新搞吧…… 能出现自己定制说明的页子 但每个方法的说明就不管用了……

#8


#9


引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……

#10


引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
过去了 看来需要研究的东西太多了 受教了  还是不知道要把这些描述放到哪……

#11


引用 9 楼 yanbuodiao 的回复:
引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。

#12


引用 11 楼 fangxinggood 的回复:
引用 9 楼 yanbuodiao 的回复:

引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。
打开是个空白页面……  我在看看

#13


引用 11 楼 fangxinggood 的回复:
引用 9 楼 yanbuodiao 的回复:

引用 8 楼 fangxinggood 的回复:
看看这个:
http://www.codeproject.com/KB/XML/xsltwsdlhelp.aspx?display=Print
xsl文件貌似过不去……


它的xlst有些问题,在namespace上少冒号
它是用xlst来解析wsdl文档。

嘿嘿 用比较麻烦的手段解决了  您说的那个方法随后研究

 [WebMethod(Description = @"<h3>根据用户所进入的系统名称和用户IDCode返回该用户的基本信息</h3>
                                     <div>
                                        <h4>
                                            输入参数:</h4>
                                        IDCode:登录人员的域账户<br />
                                        SysName:登录系统名称(注:应与MemberManager系统中的系统名称一致)<br />
                                        Mark:0:该成员无进入系统权限 1:可以进入该系统 2:该系统现在已经停止使用 3:该成员现在无进入权限了<br />
                                    </div>")]
        public DataTable GetMemberBase(string IDCode, string SysName, out int Mark)
        {
            DataTable result = null;
            Mark = 0;
            return result;
        }
就是写死点html的东东