最近用.NET Core開發API專案，本來順順好用的Swagger突然無法提供服務
後來發現是Function Naming造成，例如本來有個方法叫做GetOrders，後來又新增另一個方法叫做GetOrdersAsync，就會讓Swagger用來呈現API定義的頁面失效，要解決此問題不是去調整Swagger，而是調整Function Naming～～不要使用Async結尾的命名方式！！！
原因如下(微軟官方說明)
從ASP .NET Core 3.0開始，ASP .NET Core MVC會自動把字尾(suffix)的Async移除，routing和link都會受到此預設影響。
解決方法
方法1：修改屬性services.AddMvc(options => options.SuppressAsyncSuffixInActionNames = false);
方法2：Rename Function避免使用Async字尾
label
小技巧,
ASP .NET MVC
[GridAction(EnableCustomBinding = true)]
public ActionResult ListPO_CustomBinding(GridCommand command)
{
int totalCount = POService.QueryPOListIndex(command);
ViewBag.POTotalCount = totalCount;
List<PO> data = POService.QueryPOList(command);
//使用TelerikMvcGridCustomBindingHelper
for (int i = 0; i < (command.Page - 1) * command.PageSize; i++)
{
PO dd = new PO();
data.Insert(0, dd);
}
IQueryable<PO>
query = data.AsQueryable();
var gridHelper = new GridCustomBindingHelper<PO, PO>(command, query);
var gridModel = gridHelper.BuildGridModel();
gridModel.Total = ViewBag.POTotalCount;
return View(gridModel);
}
label
ASP .NET MVC,
Telerik
public int QueryPOListIndex(GridCommand command)
{
var entity = mydata.PO.AsQueryable();
int ttlCount = entity.ToList().Count();
return ttlCount;
}public List<PO> QueryPOList(GridCommand command)
{
var entity = mydata.PO.AsQueryable();
//Sorting(必須有Default的Order By條件,否則會Error)
entity = entity.OrderBy(order => order.PONo);
//Then paging
if (command.PageSize > 0)
entity = entity.Skip((command.Page - 1) * command.PageSize);
entity = entity.Take(command.PageSize);
return entity.ToList();
}//須注意的是, ViewBag.DataTotalCount在此頁載入時須先給予一預設值(ex:0),之後的查詢function再賦予正確值
public ActionResult ListPO()
{
ViewBag.POTotalCount = 0;
return View();
}
[GridAction(EnableCustomBinding = true)]
public ActionResult ListPO_CustomBinding(GridCommand command)
{
int totalCount = POService.QueryPOListIndex(command);
ViewBag.POTotalCount = totalCount;
List<POt> data = POService.QueryPOList(command);
return View(new GridModel
{
Data = data,
Total = totalCount
});
}@(Html.Telerik().Grid<PO>()
.Name("Grid")
.Columns(columns => {
columns.Bound(c => c.PONo);
columns.Bound(c => c.DocDate);
columns.Bound(c => c.Company);
columns.Bound(c => c.Vendor);
columns.Bound(c => c.Status);
columns.Bound(c => c.CmpltReceived);
})
.Pageable(settings => settings.Total((int)ViewBag.POTotalCount))
.DataBinding(dataBinding => dataBinding.Ajax().Select("ListPO_CustomBinding", "Inbound"))
.EnableCustomBinding(true)
.Sortable()
.Groupable()
)
label
ASP .NET MVC,
Telerik
(@Html.Telerik().Grid< mydocument>()
.Name("Grid")
.DataBinding(d => d.Ajax().Select("Query", "Home"))
)@(Html.Kendo().Grid< myDocument>()
.Name("Grid")
.DataSource(dataSource => dataSource.Ajax()
.ServerOperation(false)
.Read(read => read.Action("Query", "Home")))
)// 判斷是否第一次載入
var isFirstLoad = true;
function onDataBinding(e) {
// 當第一次載入，不呼叫 Grid Ajax Select，直接 return
if (isFirstLoad) {
e.preventDefault();
return;
}
}.ClientEvents(c => c.OnDataBinding("onDataBinding"))
label
ASP .NET MVC,
Kendo UI
<link rel="stylesheet" href="@Url.Content("~/Content/kendo.common.min.css")"> <link rel="stylesheet" href="@Url.Content("~/Content/kendo.default.min.css")"><add namespace="Kendo.Mvc.UI" />
label
ASP .NET MVC,
Kendo UI
label
ASP .NET MVC,
Kendo UI,
Telerik
label
ASP .NET MVC,
JavaScript,
jQuery
label
小技巧,
ASP .NET MVC
@Html.DropDownList("NameList", @ViewBag.NameList as IEnumerable) function loadNames(conditionMd) {
$.getJSON("_NameList", { json: conditionMd }, function (data) {
var selectList = $("#NameList");
selectList.empty();
$.each(data, function (index, optionData) {
var option = $( '').text(optionData.Text).val(optionData.Value);
selectList.append(option);
});
});
}public ActionResult _NameList(string json)
{
Dictionary< string, string> conditions = new Dictionary< string, string>();
JavaScriptSerializer jss = new JavaScriptSerializer();
conditions = jss.Deserialize< Dictionary< string, string> >(json);
Array result = getNameValues(conditions);
List< SelectListItem> items = new List< SelectListItem>();
items.Add(new SelectListItem { Text = "Plesse select", Value = "Plesse select" });
for (int j = 0; j < result.Length; j++)
{
string[] temp1 = (string[])result.GetValue(j);
items.Add(new SelectListItem { Text = temp1[0], Value = temp1[1] });
}
return Json(items, JsonRequestBehavior.AllowGet);
}
label
ASP .NET MVC
.DataKeys(datakeys =>
{
datakeys.Add(o => o.Id).RouteKey("KeyId");
datakeys.Add(o => o.Name).RouteKey("KeyName");
})function Grid_OnDelete(e) {
e.values.A= $('#myA').val();
e.values.B= $('#myB').val();
}[GridAction]
public ActionResult _AjaxDelete(string KeyId,string A, string B)
{ //略
}@(Html.Telerik().Grid()
.Name("Grid")
.DataKeys(datakeys =>
{
datakeys.Add(o => o.Id).RouteKey("KeyId");
datakeys.Add(o => o.GroupName).RouteKey("KeyGroupName");
})
.ToolBar(commands => commands.Insert().ButtonType(GridButtonType.Text).ImageHtmlAttributes(new { style = "margin-left:0" }))
.Columns(columns =>
{
columns.Bound(o => o.GroupName);
columns.Bound(o => o.Description);
columns.Bound(o => o.CloudGroup);
columns.Bound(o => o.SocialGroup);
columns.Command(commands =>
{
commands.Edit().ButtonType(GridButtonType.Text);
commands.Delete().ButtonType(GridButtonType.Text);
});
})
.DataBinding(d => d.Ajax().Select("_AjaxBinding", "Partner")
.Insert("_AjaxInsert", "Partner")
.Update("_AjaxUpdate", "Partner")
.Delete("_AjaxDelete", "Partner"))
.ClientEvents(c => c.OnDelete("Grid_OnDelete"))
) function Grid_OnSave(e) {
if (e.mode == 'edit') {
e.values.A= $('#myA').val();
e.values.B= $('#myB').val();
}
}
label
ASP .NET MVC,
Telerik
AddPartners(string[] checkedRecords, string 第二個參數, string 第三個參數) @(Html.Telerik().Grid()
.Name("Grid")
.Columns(columns => {
columns.Bound(o => o.CompanyId).ClientTemplate("< input type ='checkbox' name='checkedRecords' value='<#=CompanyId #>;<#=Name #>' / > ");
columns.Bound(o => o.Name);
columns.Bound(o => o.EnglishName);
columns.Bound(o => o.Phone);
})
.DataBinding(d => d.Ajax().Select("AjaxBinding", "Partner"))
.Pageable()
)
//按下btnAdd後要將勾選的資料傳遞到後端
< input type="button" name="btnAdd" id="btnAdd" value="Add Partner" class = "t-button" / > $(document).ready(function () {
$('#btnAdd').click(function () {
var $checkedRecords = $('input[name="checkedRecords"]:checked');
if ($checkedRecords.length < 1) {
alert('你沒有選擇任何資料列!');
return;
}
var id1 = $('#myHiddenInput').val();
var id2 = $('#myDropdownList :selected').val();
//取得勾選的checkbox
var arrayChecked = new Array();
$('input[name="checkedRecords"]:checked').each(function () {
arrayChecked.push($(this).val());
});
//送出前轉換成JSON格式
var jsonChecked = JSON.stringify(arrayChecked);
$.post('AddPartners', { jsonChecked: jsonChecked, id1: id1, id2: id2 },
function(Data) {
alert(Data.Message);
}, 'json');
});
});public ActionResult AddPartners(string jsonChecked, string id1, string id2)
{
JavaScriptSerializer jss = new JavaScriptSerializer();
string[] checkedRecords;
checkedRecords = jss.Deserialize(jsonChecked);
try
{
for (int i = 0; i < checkedRecords.Length; i++)
{
string[] Values = checkedRecords[i].Split(';');
string aa = Values[0];
string bb = Values[1];
//aa 和 bb就是前面組合的CompanyId和Name，接下來就可以繼續做其他運算
}
return new JsonResult { Data = new { Flag = "Y", Message = "OK!" } };
}
catch (Exception ex)
{
return new JsonResult { Data = new { Flag = "N", Message = ex.Message } };
}
}
label
ASP .NET MVC,
Telerik
@(Html.Telerik().Grid< mydocument>()
.Name("Grid")
.Columns(columns => {
columns.Bound(o => o.UserName).Width(100);
columns.Bound(o => o.UserId).Width(200);
columns.Bound(o => o.Address).Width(100);
})
.DataBinding(d => d.Ajax().Select("_AjaxBinding", "Home"))
.Scrollable())
label
ASP .NET MVC,
Telerik
< script type="text/javascript">
function Grid_onSave(e) {
var dataItem = e.dataItem;
var values = e.values;
var form = e.form;
//event handling code
}public class UserInfo{
public string UserName { get; set; }
public string UserId { get; set; }
public string Company { get; set; }
}var oldUser = e.dataItem.UserName; //舊的值
var newUser = e.values.UserName; //新的值
label
ASP .NET MVC,
Telerik
@(Html.Telerik().Grid()
.Name("Grid")
.Columns(columns => {
columns.Bound(o => o.CompanyId).ClientTemplate("< input type ='checkbox' name='checkedRecords' value='<#=CompanyId #>;<#=Name #>' / > ");
columns.Bound(o => o.Name);
columns.Bound(o => o.EnglishName);
columns.Bound(o => o.Phone);
})
.DataBinding(d => d.Ajax().Select("AjaxBinding", "Partner"))
.Pageable()
)
//按下btnAdd後要將勾選的資料傳遞到後端
< input type="button" name="btnAdd" id="btnAdd" value="Add Partner" class = "t-button" / > $(document).ready(function () {
$('#btnAdd').click(function () {
var $checkedRecords = $(':checked');
//先確認使用者是否沒有勾選任何資料
if ($checkedRecords.length < 1) {
alert('你沒有選擇任何資料列 !');
return;
}
//把勾選的資料傳到後端
$.post('AddPartners', $checkedRecords,
function (Data){
alert(Data.Message);
}, 'json');
});
});[HttpPost]
public ActionResult AddPartners(string[] checkedRecords)
{
try
{
for (int i = 0; i < checkedRecords.Length; i++)
{
string[] Values = checkedRecords[i].Split(';');
string aa = Values[0] ;
string bb = Values[1] ;
//aa 和 bb就是前面組合的CompanyId和Name，接下來就可以繼續做其他運算
}
return new JsonResult { Data = new { Flag = "Y", Message = "OK !" } };
}
catch (Exception ex)
{
return new JsonResult { Data = new { Flag = "N", Message = ex.Message } };
}
}
label
ASP .NET MVC,
Telerik
function OK() { var result = new Array(); $("#myListBox1 option").each(function () { var item = { Value: $(this).val(), Text: $(this).text() }; result.push(item); }); var json = JSON.stringify(result);
$.ajax({ url: '@Url.Action("MyAction")', type: 'POST', data: { json: json } });}public void MyAction(string json){ JavaScriptSerializer jss = new JavaScriptSerializer(); List< selectlistitem> myList = new List< selectlistitem>(); myList = jss.Deserialize< List< selectlistitem>>(json);}
label
ASP .NET MVC,
JavaScript,
jQuery
 |
| 圖一 |
 |
| 圖二 |
 |
| 圖三 |
function Grid_OnDataBound(e) { $("a:contains('Edit')").hide();}
label
ASP .NET MVC,
Telerik
<add namespace="Telerik.Web.Mvc.UI" />
label
ASP .NET MVC,
Telerik
 |
| 新增resx檔案及其初始屬性 |
 |
| resx內容 |
 |
| 修改Access Modifier |
 |
| 自動變更的Custom Tool屬性 |
 |
| 修改屬性值 |
protected void Application_AcquireRequestState(object sender, EventArgs e)
{
//取得瀏覽器第一個語系
string lang = HttpContext.Current.Request.UserLanguages[0];
CultureInfo ci = new CultureInfo(lang);
System.Threading.Thread.CurrentThread.CurrentUICulture = ci;
System.Threading.Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(ci.Name);
}
label
ASP .NET MVC
<%= Html.Telerik().Grid < TelerikDemo.Models.Model1 >()
.Name("Grid")
//Column設定
.Columns(columns =>
{
//隱藏欄位
columns.Bound(u => u.Id).Hidden(true);
//欄位寬度
columns.Bound(u => u.Name).Width(120);
//欄位表頭
columns.Bound(u => u.Age).Title("年齡");
//欄位格式
columns.Bound(u => u.Birth).Format("{0:yyyy/MM/dd}");
//欄位以其他控制項呈現
columns.Bound(u => u.Status)
.ClientTemplate("< select > < option value='< #= Status # >' selected='selected' >< #= Status # >< /option >< /select >");
//欄位樣式(直接設定)
columns.Bound(u => u.Tel).
HtmlAttributes(new { style = "color: green" });
})
//資料繫結Select(actionName, controllerName)
.DataBinding(dataBinding => dataBinding.Ajax().Select("_BindingModel1", "Grid"))
//頁籤設定
.Pageable(paging => paging.PageTo(3)//初載時顯示第幾頁
.Position(GridPagerPosition.Both)//分頁的位置
//提供多個PageSize讓用戶彈性更改一頁呈現幾筆資料，而決定PageSize的控制項是PageSizeDropDown
.PageSize(10, new int[] { 5, 10, 20 })
//PageInput讓使用者以keyin方式直接跳到想要的page ;
//NextPreviousAndNumeric表示同時提供上/下一頁與數字頁的功能 ;
//PageSizeDropDown提供下拉式選單更改每頁的筆數
.Style(GridPagerStyles.PageInput | GridPagerStyles.NextPreviousAndNumeric | GridPagerStyles.PageSizeDropDown))
//排序設定
.Sortable(sorting => sorting.OrderBy(order => order.Add(u => u.Name)))
//表格scrollbar
.Scrollable()
//資料分組
.Groupable()
//資料過濾
.Filterable()
.Selectable()
.ClientEvents(e => e.OnRowSelect("onRowSelected"))
%>
label
ASP .NET MVC,
Telerik
 |
| Telerik安裝完畢在C:\Program Files的檔案架構 |
 |
| VS2010多了專屬Telerik的Project Template |
<add namespace="Telerik.Web.Mvc.UI"/> <sectionGroup name="telerik"><section name="webAssets" type="Telerik.Web.Mvc.Configuration.WebAssetConfigurationSection,
Telerik.Web.Mvc" requirePermission="false" /><sectionGroup><add name="asset" preCondition="integratedMode" verb="GET,HEAD" path="asset.axd" type="Telerik.Web.Mvc.WebAssetHttpHandler,
Telerik.Web.Mvc" /> <telerik> <webAssets useTelerikContentDeliveryNetwork="true" /> telerik> <%:Html.Telerik().ScriptRegistrar().Globalization(true).DefaultGroup(g => g.Combined(true).Compress(true)) %><head><%:
Html.Telerik().StyleSheetRegistrar().DefaultGroup(g =>
g.Add("telerik.common.css").Add("telerik.vista.css").Add("telerik.rtl.css").Combined(true).Compress(true))%> < /head>
label
ASP .NET MVC,
Telerik