【C#】WebAPI,在Windows IIS平台部署

目录

前言

一、技术介绍

二、部署准备

2.1 Visual Studio本地项目配置

2.2 运行调试,以本地 localhost(或127.0.0.1)形式访问

2.3 运行调试,以本地IP(192.168.6.152)形式访问

三、详细步骤

3.1 打包发布

3.2 安装IIS(Inter***信息服务)

3.3 配置IIS(Inter***信息服务)

3.4 启动IIS,进行集成测试

四、项目异常处理

4.1 500.19-Internal Server Error

4.2 500.21-Internal Server Error

五、项目展示

4.1 文件下载

4.2 读取二维码标签

六、系列文章


前言

我能抽象出整个世界,但是我不能抽象你。 想让你成为私有常量,这样外部函数就无法访问你。 又想让你成为全局常量,这样在我的整个生命周期都可以调用你。 可惜世上没有这样的常量,我也无法定义你,因为你在我心中是那么的具体。

哈喽大家好,本专栏为【项目实战】专栏,有别于【底层库】专栏,我们可以发现增加 了『问题描述』、『项目展示』章节,十分符合项目开发流程,让读者更加清楚项目解决的问题、以及产品能够达到的效果。本专栏收纳项目开发过程的解决方案,是我项目开发相对成熟、可靠方法的提炼,我将这些问题的解决思路梳理,撰写本文分享给大家,大家遇到类似问题,可按本文方案处理。

本专栏会持续更新,不断完善,专栏文章关联性较弱(文章之间依赖性较弱,没有阅读顺序)。大家有任何问题,可以私信我。如果您对本专栏感兴趣,欢迎关注吧,我将带你用最简洁的代码,实现复杂的功能。

提示:本专栏为项目实战篇,未接触过项目开发的学生理解困难,不建议阅读。

一、技术介绍

1.1 IIS概念

互联网信息服务(英语:Inter*** Information Services,简称IIS),是由微软公司提供的基于运行Microsoft Windows的互联网基本服务。Apache是其在网络服务软件中的主要竞争者。

1.2 WebApi概念

WebAPI是一个框架,可以轻松构建HTTP服务,覆盖广泛的客户端,包括浏览器和移动设备,WebAPI是在.***Framwork上构建RESTful程序的理想平台。

以上是官网的解释,当前最新的.*** 6,在跨平台 .*** core也可以开发WebApi,不单单只是  .***Framwork平台了。这两大平台编译生成的包,并不通用,需要注意。

二、部署准备

WebAPI在项目发布部署前,我们要首先要确保没有bug,可以正常运行,以下是本地调试的步骤,如果项目已经测试OK,可以跳过。

2.1 Visual Studio本地项目配置

编写好WEBAPI代码,开始本地调试。

步骤:右键选中项目-->【属性】-->【Web】,设置Web访问的端口号,创建虚拟目录。

端口号没有具体规定,不冲突即可,往大的编,因为低位的端口号被计算机基础服务所占用。

2.2 运行调试,以本地 localhost(或127.0.0.1)形式访问

①点击工具栏【IIS Express】

②浏览地址输入接口,看是否可以访问。

2.3 运行调试,以本地IP(192.168.6.152)形式访问

127.0.0.1是回路地址,来检验本机TCP/IP协议栈,实际使用过程中服务端不在本机,是外部地址,要用IP地址测试。

我先做个演示,CMD输入以下命令找到本机IP:

Ipconfig --all

“红色框框”显示本机IP为192.168.6.152。外部用户采用IP+端口号访问,如下图浏览器访问不了,400错误。

解决方案:

  • 打开项目源码目录-->依次找 .vs\config\ applicationhost.config,如果找不到需要开启隐藏文件夹显示功能。
  • 找到< bindings>添加一行,IP为本机IP地址,如下图所示:
  • 重启VS(一定要重启),并以管理员身份运行调试。注意看右下角任务栏,IIS Express出现了本机IP。
  • 回到浏览器,刷新请求,ok。


三、详细步骤

本节我们开始进行正式发布。

3.1 打包发布

选中项目解决方案-->【发布】-->【IIS、FTP等】-->【发布】-->发布方法选“文件系统”、选择发布的路径。

我选择路径:

D:\WEBAPI

下一步,勾选“在发布前删除所有现有文件”。

保存,等待发布完成。此时我们路径下会得到几个文件。

3.2 安装IIS(Inter***信息服务)

本文介绍在IIS上部署,当然你也可以选择Tomcat,原理都一样,承载软件。

 安装IIS功能

控制面板-->程序和功能-->启用和关闭Windows功能-->IIS相关功能勾选。如下图:

3.3 配置IIS(Inter***信息服务)

点击搜索“IIS”,创建网站,选择项目发布的路径,如下图:

3.4 启动IIS,进行集成测试

浏览器输入地址localhost:8090/api/OR/Test,当然你输入本机IP、127.0.0.1也都是可以访问的,出现如下界面可返回数据就大功告成了。


四、项目异常处理

我这里分析了可能出现的报错情况,请按下方报错提示处理:

4.1 500.19-Internal Server Error

IIS 7访问的时候出现以下异常:

不能在此路径中使用此配置节。如果在父级别上锁定了该节,便会出现这种情况。锁定是默认设置的(overrideModeDefault="Deny")......

解决方案:

因为 IIS 7 采用了更安全的 web.config 管理机制,默认情况下会锁住配置项不允许更改。

以管理员身份运行命令行

C:\windows\system32\i***srv\appcmd unlock config -section:system.webServer/handlers

其中的 handlers 是错误信息中红字显示的节点名称。

如果modules也被锁定,再运行

C:\windows\system32\i***srv\appcmd unlock config -section:system.webServer/modules

4.2 500.21-Internal Server Error

解决方案:

这是没有执行注册asp***导致的,cmd注册C:\Windows\Microsoft.***\Framework64\v4.0.30319\aps***_regiis.exe -i。

如果错误依旧存在,再运行cmd,然后使用dism工具依次执行以下指令即可:

dism /online /enable-feature /featurename:IIS-ISAPIFilter

dism /online /enable-feature /featurename:IIS-ISAPIExtensions

dism /online /enable-feature /featurename:IIS-***FxExtensibility45

dism /online /enable-feature /featurename:IIS-ASP***45

这样,你就可以正常访问API接口了。


五、项目展示

我的WebAPI项目已经部署完成了,你们的怎么样?这里我展示一下部分,我服务端所能提供的功能,我采用Postman接口工具向你们展示了。

4.1 文件下载

复制到浏览地址栏,回车可以直接跳出下载的包。

4.2 读取二维码标签

六、系列文章

C#】单号生成器(编号规则、固定字符、流水号、产生业务单号)
本文链接:https://blog.csdn.***/youcheng_ge/article/details/129129787

【C#】日期范围生成器(构建开始日期、结束日期)
本文链接:https://blog.csdn.***/youcheng_ge/article/details/129040663

【C#】数据实体类使用
本文链接:https://blog.csdn.***/youcheng_ge/article/details/128816638

【C#】单据审批流方案
本文链接:https://blog.csdn.***/youcheng_ge/article/details/128972545

【C#】二维码标签制作及打印
本文链接:https://blog.csdn.***/youcheng_ge/article/details/126884228

【C#】最全单据打印源码(设计打印模板、条形码&二维码、标签、字体)

本文链接:https://blog.csdn.***/youcheng_ge/article/details/129415723

【C#】条码管理操作手册
本文链接:https://blog.csdn.***/youcheng_ge/article/details/126589496

【C#】IIS平台下,WebAPI发布及异常处理
本文链接:https://blog.csdn.***/youcheng_ge/article/details/126539836

【C#】【提高编程效率】代码模板生成工具
本文链接:https://blog.csdn.***/youcheng_ge/article/details/126890673

【C#】【提高编程效率】Excel数据批量导入数据库
本文链接:https://blog.csdn.***/youcheng_ge/article/details/126427323

【C#】Windows服务(Service)安装及启停方案
本文链接:https://blog.csdn.***/youcheng_ge/article/details/124053794

【C#】穿透Session隔离,服务调用外部程序(无窗体界面解决)
本文链接:https://blog.csdn.***/youcheng_ge/article/details/124053033

【C#】任务计划实现,使用Quartz类
本文链接:https://blog.csdn.***/youcheng_ge/article/details/123667723

【C#】《周计划管理关于产前准备模块》解决方案20200203
本文链接:https://blog.csdn.***/youcheng_ge/article/details/122919543

【C#】源码解析的正则表达式
本文链接:https://blog.csdn.***/youcheng_ge/article/details/118337074

【C#】软件版本和文件MD5记录(XML操作)
本文链接:https://blog.csdn.***/youcheng_ge/article/details/112513871

【C#】如何测试网络是否连通
本文链接:https://blog.csdn.***/youcheng_ge/article/details/110137288

【C#】根据名称获取编码(Dictionary获取key方法)
本文链接:https://blog.csdn.***/youcheng_ge/article/details/129816701

【Inno Setup】安装包制作,项目打包方案

 本文链接:https://blog.csdn.***/youcheng_ge/article/details/123665633

转载请说明出处内容投诉
CSS教程_站长资源网 » 【C#】WebAPI,在Windows IIS平台部署

发表评论

欢迎 访客 发表评论

一个令你着迷的主题!

查看演示 官网购买