Особенности

Минималистичная (размер DLL всего 20KB) и простая в использовании.
Поддержка .NET Standard 2.0/.NET 4.6/.NET 4.5/.NET 4.0
Без использования сторонних библиотек
Поддержка анонимных типов, Dapper Dynamic Query, List/Array/Set/Enumerable, DataTable, Dictionary

Установка

Вы можете установить пакет через NuGet с помощью диспетчера пакетов Visual Studio или через NuGet UI:

PM> install-package HtmlTableHelper

или с помощью командной строки dotnet:

dotnet add package HtmlTableHelper

Fiddle Demo:

Быстрый старт

##### Пример для List/Array/Set/Enumerable не Key/Value типа ``C# using HtmlTableHelper; .. var sourceData = new[] { new { Name = "ITWeiHan", Age = "25",Gender = "M" } }; var tablehtml = sourceData.ToHtmlTable(); /* Результат:

Name	Age	Gender
ITWeiHan	25	M


*/

##### Пример с DapperC#
using (var cn = "Ваше подключение")
{
	var sourceData = cn.Query(@"select 'ITWeiHan' Name,25 Age,'M' Gender");
	var tablehtml = sourceData.ToHtmlTable();
}

##### Пример с Dictionary C#
var sourceData = new[] {new Dictionary (){{"Name" , "ITWeiHan" },{"Age",25},{"Gender","M"}}};
var tablehtml = sourceData.ToHtmlTable();

Пользовательские атрибуты Table/TR/TD/TH (Dynamic Type)
C#
var data = /List/Array/Set/Enumerable../;
var html = data.ToHtmlTable( tableAttributes: new { @class = "SomeClass"} //это dynamic type, поддерживаются любые атрибуты 
    ,trAttributes: new { ID = "SomeID" },tdAttributes: new { width = "120 px" },thAttributes: new { @class = "dark-theme" }
);
/*
Результат:

	
		
			..
		
	
	
		
			..
		
	

*/

##### Аннотация атрибутов###### 1. Display : C#
public class ModelClassWithDisplayAttr
{
    [TableColumn(DisplayName = "Column1")] //Свойство MyProperty1 отрисует innertext thead-td: "Column1"
    public string MyProperty1 { get; set; }
    [TableColumn(DisplayName = "Column2")] //Свойство MyProperty2 отрисует innertext thead-td: "Column2"
    public string MyProperty2 { get; set; }
}

###### 2. Пропуск : C#
public class ModelClassWithSkipAttr
{
    [TableColumn( Skip = true)]
    public string MyProperty1 { get; set; } //MyProperty1 не будет отображаться в html
    public string MyProperty2 { get; set; }
}

##### HTMLTableBuilder###### HtmlCaptionC#
var soucreData = new []{ new {MyProperty1="test",MyProperty2=123} };
var html = soucreData.CreateBuilder()
    .SetCaption("This is Caption", new { id = "CaptionId" })
    .ToHtmlTable();
//Результат : This is CaptionMyProperty1 MyProperty2
test 123

##### HTMLTableSettingНастраиваемое кодирование InnerHtml (Не рекомендуется делать это без особой необходимости, из-за XSS атак)C#
var sourceData = new[] { new { Name = "ITWeiHan" } };
//Кодирование по умолчанию
var encodinghtml = sourceData.ToHtmlTable();
//Результат: 
..<b>ITWeiHan</b>..
var htmltablesetting = new HTMLTableSetting()
{
    IsHtmlEncodeMode = false
};
var notEncodinghtml = sourceData.ToHtmlTable(HTMLTableSetting: htmltablesetting);
//Результат: 
..ITWeiHan..

Расширение
ASP.NET Core MVC:  
Создайте файл IHtmlHelperExtension.csC#
using System.Collections.Generic;
using HtmlTableHelper;
using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.AspNetCore.Html;
public static class IHtmlHelperExtension
{
    public static HtmlString ToHtmlTable(this IHtmlHelper htmlHelper, IEnumerable enums
        , object tableAttributes = null, object trAttributes = null, object tdAttributes = null
        , HtmlTableSetting HTMLTableSetting = null)
    {
        var html = enums.ToHtmlTable(tableAttributes, trAttributes, tdAttributes, HTMLTableSetting);
        return new HtmlString(html);
    }
    public static HtmlString ToHtmlTable(this IHtmlHelper htmlHelper, System.Data.DataTable datatable
        , object tableAttributes = null, object trAttributes = null, object tdAttributes = null
        , HtmlTableSetting HTMLTableSetting = null)
    {
        var html = datatable.ToHtmlTable(tableAttributes, trAttributes, tdAttributes, HTMLTableSetting);
        return new HtmlString(html);
    }
}

razor.cshtml C#
@Html.ToHtmlTable(new[] { new { Name = "ITWeiHan", Age = "25", Gender = "M" } })
/*
Результат:Name Age Gender
ITWeiHan 25 M
*/

ASP.NET MVC 5:   
Создайте файл HtmlHelperExtension.csC#
using System.Collections.Generic;
using HtmlTableHelper;
using System.Web;
using System.Web.Mvc;
public static class HtmlHelperExtension
{
    public static HtmlString ToHtmlTable(this HtmlHelper htmlHelper, IEnumerable enums
        , object tableAttributes = null, object trAttributes = null, object tdAttributes = null
        , HtmlTableSetting HTMLTableSetting = null)
    {
var html = enums.ToHtmlTable(tableAttributes, trAttributes, tdAttributes, HTMLTableSetting);
return new HtmlString(html);
}public static HtmlString ToHtmlTable(this HtmlHelper htmlHelper, System.Data.DataTable datatable
    , object tableAttributes = null, object trAttributes = null, object tdAttributes = null
    , HtmlTableSetting HTMLTableSetting = null)
{
    var html = datatable.ToHtmlTable(tableAttributes, trAttributes, tdAttributes, HTMLTableSetting);
    return new HtmlString(html);
}
}
Демонстрация
Демонстрация ASP.NET MVC 5 JQuery DataTable:

C#
using HtmlTableHelper;
//..
public class HomeController : Controller
{
    public ActionResult Index()
    {
        var datas = new[] { new { Name = "ITWeiHan", Age = "25",Gender = "M" } };
        ViewBag.Table = datas.ToHtmlTable();
        return View();
    }
}
C#
@{
    Layout = null;
}


    
    AspNetMvcDemo
    


    

        @Html.Raw(ViewBag.Table)
    
    
    
    


Демонстрация ASP.NET Core:C#
public class Startup
{
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        app.Run(async (context) =>
        {
            var sourceData = new[] { new { Name = "ITWeiHan", Age = "25",Gender = "M" } };
            var tablehtml = sourceData.ToHtmlTable();
            await context.Response.WriteAsync(tablehtml);
        });
    }
}




---


Tranlated By Open Ai Tx | Last indexed: 2025-06-30


---