跳到主要內容

[MVC] ASP.NET MVC 專案加上 API 說明頁面

  • 新增 Empty 專案,參考勾選 MVC 和 Web API


  •  加入 具有讀取/寫入動作的 Web API 控制器




  • 瀏覽網頁http://localhost:xxx/api/Get 會因為不同瀏覽器顯示不同格式,修改 App_Start\WebApiConfig.cs,加入以下這一行,讓 ASP.NET Web API 永遠只回應 JSON 格式
GlobalConfiguration.Configuration.Formatters.XmlFormatter.SupportedMediaTypes.Clear();

  •  在每個 function 增加描述 ,打 /// 會自動產生 <summary>


  • 產生專案的XML文件

 「專案屬性」→ 「建置」→ 
勾選「XML 文件檔案」,路徑改 App_Data\XmlDocument.XML→ 
建置專案就會自動在 App_Data 目錄下產生 XmlDocument.XML 檔案

  • NuGet 安裝 Microsoft.AspNet.WebApi.HelpPage 套件
  • 開啟 Areas/HelpPage/App_Start/HelpPageConfig.cs ,把以下程式碼註解取消
config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));


重點是確認路徑是否正確 "~/App_Data/XmlDocument.xml"


  • 瀏覽 http://localhost:xxx/Help 

參考連結

留言

這個網誌中的熱門文章

[python] python 時區轉換 ( timezone )

python 時區轉換 import datetime as dt import pytz d = dt.datetime(2019,1,1,14,0,0) #create Taipei timezone tw = pytz.timezone('Asia/Taipei') #set d timezone is 'Asia/Taipei' twdt = tw.localize(d) #change to utc time utc_dt = twdt.astimezone(pytz.utc) *注意 網路上很多使用 d.replace(tzinfo=tw)   但是可能會出現時差問題, 如下: datetime.time(23, 18, 5, tzinfo=<DstTzInfo 'Asia/Shanghai' LMT+8:06:00 STD>) 參考文件 python时区设置——pytz模块

[HTML] 文字浮水印效果 text watermark css

[.css] .info-mask {     height: 0;       position: absolute;       margin-top:120px;   } .info-opacity {     opacity: 0.8;     color: black; } .info-text {     color: gray;     font-size: 40px;     -webkit-transform: rotate(-5deg);       line-height: 60px;     max-width:1200px;     letter-spacing:3px;     padding-left:0.8em; } [.html]     <div class="info-mask">         <p class="info-text">             WaterMarkText         </p>     </div>    <table class="table table-bordered table-striped table-responsive table-hover" style="position:                 relative;" >        <tbody class="info-opacity" >        </tbody>    </table>

[Linux] 解決 unix ///tmp/supervisor.sock no such file

supercisor run  一段時間系統會自動刪除tmp內的檔案, 這時候就會出現以下問題: unix ///tmp/supervisor.sock no such file 作業環境: Centos 7 *解決方法 修改 supervisor 設定檔 [...]#  vim /etc/supervisor/supervisord.conf [unix_http_server] file= /var/run/ supervisor.sock  ... [supervisord] logfile= /var/log/ supervisord.log ... [supervisorctl] serverurl=unix:/// var/run/ supervisor.sock 重新執行supervisor  關閉supervisor相關進程 [...]#  ps -ef | grep supervisord   [...]#  kill (進程id) 重新執行supervisor [...]# supervisord or [...]# supervisord -c /etc/supervisor/supervisord.conf 參考連結 解决unix:///tmp/supervisor.sock no such file的问题