Westwind.AspNetCore
公用事业库为ASP.NET Core提供有用的帮助者,格式化和扩展
这是一个小软件包,提供了许多便利助手和扩展类,可促进ASP.NET Core API和MVC应用程序中的常见操作以及一般而言。
您可以按原样使用此软件包,也可以使用源代码选择并选择添加到您自己的应用程序中 – 大多数功能都是独立的,并且易于移动和集成。
安装
您可以在Visual Studio中的Nuget安装包装:
Westwind.AspNetCore包
PM > install-package Westwind.AspNetCore
或dotnet命令行:
dotnet add package Westwind.AspNetCore
文档
可以在此处找到图书馆的类参考:
- Westwind.AspNetCore类参考文献
特征
一般ASP.NET功能
-
formVariableding unbind unndinds形式向对象
Request.Formunbinding例程,使您可以将形式变量解开为现有对象,仅在请求表格上下文中可用的属性。在许多情况下,这可能比创建新对象的模型绑定要容易得多,因此需要跟踪更改。 -
自定义HTTP标头中间件
允许使用中间件配置将HTTP标头添加和删除到每个请求中。这是ASP.NET核心基础库中缺少的作品。 -
httprequest扩展
-
GetBodyStringAsync()和GetRawBodyBytesAsync()– 检索原始的非json内容 -
GetUrl()– 返回当前请求的绝对URL。 -
Params()– 从表单,查询或会话集合中返回项目。 -
IsFormVar()– 确定是否存在表单变量 -
IsPostback()– 确定请求是否是邮政/PUT操作 -
IsLocal确定当前URL是否是本地机器URL -
UnbindFormVars()– 将vars形式vars变成对象(使用formVariable粘合剂)
-
-
httpContext扩展
-
MapPath()– 映射磁盘上物理路径的虚拟路径 -
ResolvePath()– 解决完全合格的站点路径(〜 /, /)的相对路径 -
SetUserLocale()– 让您轻松地设置用户语言环境和uilocale的请求
-
-
DataProtector包装器
帮助您更容易使用DataProtector API创建安全令牌。 -
USERSTATE HERPER
USERSTATE对象大大简化了可以在请求中存储的auth“缓存”用户数据。对于诸如用户名,主要ID之类的内容以减少数据库查找或仅仅以跨请求携带全局值的内容。数据存储在身份声明或自定义加密的cookie中。该类支持序列化,自动加载和保存。可以通过子类和添加自己的自定义属性来扩展,以跟踪几个常见的属性。 -
Weutils
-
EncodeJsString()– json的字符串编码没有库要求 -
DecodeJsString()– JSON的字符串解码无库要求 -
EncodeJsDate()– JSON的数据编码没有库要求
-
-
Gravatar
Gravatar类,可以迅速使您将GravatarLink()和GravatarImage()嵌入页面。
MVC功能
-
BaseController和BaseViewModel实现
一个通用的基本控制器类,添加了对其他VM可以继承的自动定位基本视图模型的支持。允许自动初始化常见功能,例如ErrorDisplay和Base View模型。 -
ViewRenderer
使用控制器上下文将Razor/MVC视图输出到字符串。 -
Appuser SpairSprincipal和Cookie身份验证助手
包装ClaimsPrincipalAppUser类,使添加和检索索赔并轻松从单个辅助对象登录并登录全部。 -
剃须刀错误显示组件基于自举警报
提供您直接建模的<error-display>Razor组件,或者您可以在Overloadloaded ViewModel组件中使用BaseViewModel类上的内置ErrorDisplayModel。在大多数MVC应用程序中,您需要某种错误显示,并且此ErrorDisplay taghelper使得从自定义
ErrorDisplayModel输入显示警报框很快。ShowError(),ShowSuccess()或ShowInfo()等助手方法在BaseViewModel上使在页面上显示错误和信息消息非常容易,一贯
API功能
-
Baseapicontroller API基类,包括异常捕获和显示,可以与UserState一起使用,并通过auth令牌或其他自定义验证机制的请求传递。类似于基本控制,但针对API操作进行了优化。
-
ApiexceptionFilter错误处理和Apiexception
自定义API错误过滤器实现,该实现返回异常上的JSON API响应。还提供了标准化的ApiExecption类,可用于轻松抛出返回特定HTTP响应代码的异常。 -
API基本响应对象
可用于返回一致的API结果的ApiResponse基类,其中包括错误状态,错误消息,状态代码以及实际数据。键入版本和未型版本。 -
RAWREQUEST身体弦格式
允许接收原始非json内容的API formatter来string和byte[]参数,否则MVC的API实现不支持。博客文章中的更多信息。 -
用户令牌管理器
移至westwind.utilities.data一个数据库驱动的令牌管理器,可以创建,存储,验证和管理短期生成的令牌的寿命。对于创建初始身份验证后分配的代币,然后用于API访问。 -
JWT助手使在ASP.NET auth配置中创建JWT令牌变得更加容易
一般ASP.NET核心
执照
WestWind.Web.MarkDownControl库是一家许可的开源产品:
- 麻省理工学院许可证
所有源代码均为©West Wind Technologies ,无论对它们的更改如何。任何源代码修改都必须使原始版权代码标头(如果存在)完整。
无需使用,集成或修改此项目的代码。您可以自由在个人,商业,政府和任何其他类型的应用程序中使用它,并且可以自由修改用于自己的项目中的代码。
回馈
如果您觉得这个库有用,请考虑主演存储库和/或考虑进行小捐款:
- 赞助我在GitHub赞助商上的工作
更新历史记录
-
版本4.0
物理上从包装中删除了UsertokenManager(有关初始弃用,请参见v3.20)。 -
版本3.20
从此软件包中删除了UserTokenManager类,并将其移至westwind.utilities.data,以从此软件包中删除SQL库的默认足迹。
打破变化
UserTokenManager的Usertokens表的结构随着其他一些字段而发生了变化。该表必须更新以包括其他字段。如果您的数据库具有连接字符串的写入访问权限,则可以删除表并重建。否则,请查看最新结构和SQL语句的UserTokenManager.CreateUserTokenSqlTable()方法。
