C#构建Web服务项目实战（一）

news2024/11/24 0:15:27

概述

本文通过VS2017，利用C#语言构建一个Web应用项目（旧的ASP.NETWeb应用，非微软最新的.NETCore），并演示了如何利用Windows的IIS服务发布项目（网站），以及在发布项目（允许用户远程访问）和项目（本地）调试之间遇到的一些问题及解决方案。

环境

  • Visual Studio 2017（VS2019类似）

  • Windows 11

  • .NET Framework 4.8

创建项目

启动VS2017，选择新建项目，创建一个ASP.NET Web应用程序。（PS：如果不能选择相关的语言，例如C#和所需的应用程序类型，则需要按照提示更新VS2017的安装组件，选择相应的组件安装即可）

选择创建一个空的Web项目。

保持默认选择，点击‘确定’按钮。

新项目（解决方案）的内容列表如上图，包括5项内容：

  • Connected Services

  • Properties，其下有一个AssemblyInfo.cs文件，顾名思义是项目程序集的配置信息，通常我们不会直接修改它。

  • 引用目录，是项目引用的外部模块。

  • packages.config文件，类似于nodejs的项目依赖配置文件，XML文件格式。

  • Web.config文件，关于项目Web服务的配置文件，分为Debug和Release版。

右键点击项目，选择‘添加’->‘新建项’。

在‘添加新项’页面中，选择添加‘Web服务（ASMX）’。

一个简单的Webservice就创建完成了，项目目录下增加了一个‘WebService1.asmx’文件。

该文件内容如下：

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Services;

namespace MyWebApp

{

/// <summary>

/// WebService1 的摘要说明

/// </summary>

[WebService(Namespace = "http://tempuri.org/")]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[System.ComponentModel.ToolboxItem(false)]

// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消注释以下行。

// [System.Web.Script.Services.ScriptService]

public class WebService1 : System.Web.Services.WebService

{

[WebMethod]

public string HelloWorld()

{

return "Hello World";

}

}

}

文件中使用了如下的宏定义：

  • [WebService(…)]

  • [WebServiceBingding(…)]

  • [System.ComponentModel.ToolboxItem(false)]

  • …

  • [WebMethod]

  • …

其中[WebMethod]之后紧随一个HelloWorld()方法。关于C#中的[WebMethod]的用法，可参考：https://blog.csdn.net/m18633778874/article/details/79659144

照猫画虎，添加两个方法。

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Services;

namespace MyWebApp

{

/// <summary>

/// WebService1 的摘要说明

/// </summary>

[WebService(Namespace = "http://tempuri.org/")]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[System.ComponentModel.ToolboxItem(false)]

// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消注释以下行。

// [System.Web.Script.Services.ScriptService]

public class WebService1 : System.Web.Services.WebService

{

[WebMethod]

public string HelloWorld()

{

return "Hello World";

}

[WebMethod(Description = "加法")]

public int Add(string a, string b)

{

int sum = 0;

sum = Convert.ToInt32(a) + Convert.ToInt32(b);

return sum;

}

[WebMethod(Description = "乘法")]

public int Multiply(string a, string b)

{

int rsult = 0;

rsult = Convert.ToInt32(a) * Convert.ToInt32(b);

return rsult;

}

}

}

PS：如果方法需要通过Webservice的地址进行调用，则需要在方法前面增加[WebMethod]的宏定义，Description是对方法的描述。

生成并调试（按下F5键运行），项目会启动一个（系统默认）浏览器（例如Microsoft Edge、Chrome等）。

上面界面的信息量较大，例如Web服务的端口号，项目的命名空间（默认为http://tempuri.org）。可以点击页面的各链接，看看项目的实际配置情况，其中有关项目操作说明，例如客户端应该如何调用服务端的方法。

回到VS2017，按下‘Shift+F5’，终止项目运行，Web浏览器关闭。

Web服务发布（网站创建）

上面的访问是通过集成调试环境运行程序临时建立的Web服务，其他应用程序或远程用户需要访问项目的Web服务，则需要部署Web服务器。

微软（Windows）系统的Web服务由系统IIS服务提供。通过开始菜单-> 控制面板（可以通过在开始菜单界面中输入控制面板查询）-> 程序-> 启动或关闭Windows功能-> 选中‘Internet Information Services’功能，点击确定即可。

点击确定完成Windows系统服务的更新。

回到VS2017，右键点击项目，选择‘发布’。

在‘选取发布目标’窗口中，选择‘文件夹’，其他保持不变。

输出窗口显示发布成功。

浏览项目文件夹，新增了‘bin/Release/Publish’文件夹，该文件夹就是后面在IIS中添加网站所用到的文件夹。该文件夹的内容如下。

其中bin目录下包含了项目可执行文件（本文未在此展开说明）。

bin目录下还有一个自动生成的‘roslyn’目录，目录下有大量文件，Windows的黑盒子太多了，这个目录应该是不便于手动配置的，应该在每次项目更新后，选择Release，选择重新生成项目，然后再选择发布（项目），则Publish下面的内容，包括roslyn目录下的内容，将会自动更新。

现在项目发布完成了，接下来需要打开IIS管理器，进行本地主机的网站发布（Web服务配置）。

在开始菜单中输入‘IIS’，出现‘IIS管理器’，然后点击运行IIS管理器，在IIS管理器界面中右键点击‘网站’，选择‘添加网站’。

在‘添加网站’界面中，物理路径选择上面在VS2017项目中发布的路径‘bin/Release/Publish’，IP地址选择本地网络配置的IP地址即可，本地有多个IP的话，需要选择，端口默认为80（本例实际配置为8081），可以自行指定一个空闲的端口，主机名是用于DNS服务的，本地通常用不上，随便配置一个即可，本例中例如配置为‘www.mywebsite.com’。（备注：通过后面的调试结果，不能配置主机名，主机名保留为空。）

配置IIS 网站完成后，IIS管理器中新增一个网站。

点击上图右侧的‘浏览网站’下的链接，启动一个浏览器窗口，报错。

将上面的链接更改为IP地址：http://192.168.123.24:8081，其中IP地址根据主机实际的IP地址设定，仍然报错，如下。

此问题通常是刚发布的网站对应的文件目录的权限设置问题造成。在IIS管理器中选择左侧网站，再选择（点击）右侧‘编辑权限’，弹出文件目录属性设置窗口。

在弹出的属性窗口中，选择‘安全’属性页。

可以看出，在‘组或用户名(G)’列表中没有IIS用户，点击‘编辑’按钮更改（配置）目录用户及其权限。在弹出的窗口中，点击‘添加’。

在弹出的‘选择用户或组’窗口中，点击‘高级’按钮。

在接下来的窗口中，点击‘立即查找’按钮。

接着，在搜索结果列表中找到并选中‘IIS_USERS’，然后点击‘确定’按钮。

回到上一个界面，IIS_USERS出现在列表框中，继续点击‘确定’按钮。

继续回到上一级界面，显示在Publish目录的访问组或用户名中，增加了IIS_USERS，保持窗口下部的IIS_USERS的权限为默认设置（可以根据网站实际需要进行配置，例如运行IIS_USERS）的写入权限等，点击‘确定’按钮。

这里有个小陷阱，前面对网站的配置中，指定了主机名为：www.mywebsite.com，该主机名会自动出现在访问链接中。正确方法是，不指定主机名，将主机名设置为空。设置方法：选择网站，点击右侧编辑网站中的‘绑定’，在弹出的窗口中选择配置（只有一条配置），然后选择‘编辑’按钮，在编辑网站绑定窗口中删除主机名。

再次回到IIS管理器窗口，点击浏览网站。

继续弹出错误提示窗口。

此错误是因为没有为网站配置默认的文档，当然也可以配置用户可以列出Web服务器的目录内容（另一个话题）。

在IIS管理器窗口中，选中网站，双击中间窗口的‘默认文档’。

在弹出的窗口中点击右侧的‘添加’，继续在弹出的添加默认文档窗口中输入VS2017项目默认为项目添加的Web服务文件（WebService1.asmx）。

回到默认文档界面，可以看出一个ISS网站默认的启动文件有许多包括：

  • Default.htm

  • Default.asp

  • index.htm

  • index.html

  • iisstart.htm

PS: 网站会按列表顺序查找启动网页，可以手动在Publish目录中添加上述列表文件中的任意一个，都可以启动网站。

继续浏览网站，仍然报错，这次的错误信息如下。

根据提示，应该是服务器不能正确运行IIS_USERS用户访问的.asmx文件。回到控制面板，再次配置Windows（参见前述，启用或关闭Windows功能），选择IIS服务（Internet Information Services），选择‘万维网服务’->‘应用程序开发功能’，根据自己项目的设置配置如下。如果不清楚自己项目的配置，可以全部选中，点击‘确定’按钮完成IIS服务配置即可。

终于出现了期待的页面！！！

点击页面中的各方法（之前在Web项目中定义的方法），页面会有针对各方法的访问（调用）的详细说明。

重新发布后的问题

Windows的配置，真的是麻烦多。重新编译并发布项目后，启动项目调试，又提示错误。

根据网上的各种解决方案，需要开启网站的目录浏览权限。方法：启动IIS管理器，选择网站，双击窗口中间功能视图中的‘目录浏览’。

在接下来的窗口中，点击‘启动’。

启用后，结果如下。

此时（远程启动访问！注意不是本地调试模式）启动浏览器访问网站，结果如下。

也就是说通过目录浏览权限的设置，远程Web用户可以浏览目录的内容，其实并不是我们想要的起始页面的内容，点击文件‘WebService1.asmx’，出现期望的启动页面。

仔细查看原因，发现VS2017在每次发布项目后，会重置网站默认的‘默认文档’的设置，就是把我们之前（参见前述）设置的启动页面‘WebService1.asmx’从列表中又删除了。重新将该文件列入启动文件列表，则访问网站后看到所期望的页面，如下。

经测试，每次通过VS2017重新发布项目后，都会重置‘目录浏览’和‘默认文档’的设置，需要在每次发布项目之后通过IIS管理器进行相关的设置。

项目调试中的Web服务配置

然而，新的问题又来了！

之前创建项目，然后执行调试，一切OK，能够正确启动浏览器，参见前文，将前文的图片重新拷贝过来。

可以看到访问链接为‘localhost:51947/WebService1.asmx’。然而，经过前述的项目发布后再执行调试，出现如下的错误页面。

可以看到，端口号不一样，本机（网页）发布的物理路径也不一样，确实是两个不同的Web服务。上面的发布是通过本地主机Windows系统的IIS服务提供的访问，此处是在VS集成编译环境中按F5键的调试，是编译环境（VS2017）提供的一个临时的Web服务，不过之前好好的，为啥项目经发布后，调试又不行了呢。那个临时的端口号‘51947’在哪里配置的呢？（经查，该配置是在项目属性-> Web 配置中指定的，可根据需要修改，本例中未作调整。）

经多方考察和验证，需要在项目文件Web.config中增加相关信息，然后就可以正常调试了。

如图，增加‘<system.webServer>’标记，并根据需要增加‘<directoryBrower…>’标记的内容，或‘<defaultDocument…>’标记的内容。如果只是增加‘<directoryBrower…>’标记及相关内容，则调试的时候默认列举目录内容，然后再点击相关的文件进入下一步。如果增加了‘<defaultDocument …>’标记中的内容，则调试将直接打开指定的文件，例如本例中的‘WebService1.asmx’。（PS: 在<add value=”…”>标记中，只需要指定文件名，不需要指定文件的路径）。

终于全部OK了，既可以项目调试，也可以项目发布。记住在重新发布项目后，需要通过IIS管理器重新指定发布网站的默认文档，或允许网站的目录浏览。

后续将学习和研究客户端对C#所创建的Web服务端的各种交互操作。。。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/142124.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

C语言及算法设计课程实验三：最简单的C程序设计——顺序程序设计(三)

C语言及算法设计课程实验三：最简单的C程序设计——顺序程序设计(三)

C语言及算法设计课程实验三&#xff1a;最简单的C程序设计——顺序程序设计&#xff08;三&#xff09;一、实验目的二、 实验内容2.3、计算存款利息三、 实验步骤3.3、顺序程序设计实验题目3&#xff1a;计算存款利息的实验步骤3.3.1、变量的声明3.3.2、变量的赋值3.3.3、计算…
阅读更多...
递归分治时间复杂度主定理法

递归分治时间复杂度主定理法

记录一下以前博客的证明过程&#xff0c;补充一下之前的结论 在算法导论中lgn一般指2为底的对数n&#xff0c;特此说明 以前写的博客记录了一下分治递归时间复杂度的结论&#xff0c;发现少了一个正则条件&#xff0c;而且也不覆盖所有的一般情况 https://blog.csdn.net/qq_1…
阅读更多...
乌鸦安全2022年度文章合集

乌鸦安全2022年度文章合集

说明 乌鸦安全2022年精选原创文章合集&#xff0c;基本上大部分都是原创&#xff0c;当然还有一部分文章由其他师傅投稿提供&#xff0c;在此感谢各位师傅的投稿和帮助&#xff01; 乌鸦安全2021年度文章合集 你可以在这里找到我&#xff1a; GitHub&#xff1a;https://gi…
阅读更多...
开源的工作流都有哪些特征？

开源的工作流都有哪些特征？

开源的工作流是什么&#xff1f;都有什么样的特征和优势特点&#xff1f;众所周知&#xff0c;随着现代化办公管理的兴起&#xff0c;工作效率高的低代码开发平台涌上前线&#xff0c;成为很多企业实现数字化转型和做好数据管理的重要系统。这篇文章主要是围绕开源的工作流方面…
阅读更多...
记一次2022某地HVV中的逆向分析

记一次2022某地HVV中的逆向分析

声明&#xff1a;本文仅限于技术讨论与分享&#xff0c;严禁用于非法途径。若读者因此作出任何危害网络安全行为后果自负&#xff0c;与本号及原作者无关。 前言 事情是这样的&#xff0c;国庆前期某地HVV&#xff0c;所以接到了客户通知他们收到了钓鱼邮件想要溯源 直接下载…
阅读更多...
云视频会议系统私有化实践

云视频会议系统私有化实践

点击上方“LiveVideoStack”关注我们▲扫描图中二维码或点击阅读原文▲了解音视频技术大会更多信息编者按&#xff1a;云视频会议系统支持多服务器动态集群部署&#xff0c;并提供多台高性能服务器&#xff0c;大大提升了会议稳定性、安全性、可用性。视频会议为用户大幅提高沟…
阅读更多...
（Java高级教程）第三章Java网络编程-第一节2：网络编程必备网络知识2之网络协议分层

（Java高级教程）第三章Java网络编程-第一节2：网络编程必备网络知识2之网络协议分层

文章目录一&#xff1a;生活中的协议分层&#xff08;1&#xff09;生活中的分层1——汉堡包&#xff08;2&#xff09;生活中的分层2——打电话二&#xff1a;网络分层&#xff08;1&#xff09;OSI七层模型&#xff08;2&#xff09;TCP/IP分层模型三&#xff1a;OSI参考模型…
阅读更多...
前端基础(六)_流程控制语句(if、if-else、if-else嵌套、switch)

前端基础(六)_流程控制语句(if、if-else、if-else嵌套、switch)

流程控制语句主要分为 : 顺序结构&#xff1a;即按顺序执行代码 ;条件选择结构 ( 分支语句 )&#xff1a;包括 if-else 以及 switch;循环结构&#xff1a;包括 for循环&#xff0c;while&#xff0c;do-while,for-in 等;其他语句&#xff1a; break 和continue。 一、流程控制…
阅读更多...
Java学习（23）Java一维数组概述

Java学习（23）Java一维数组概述

什么是数组 数组是相同类型的数据按顺序组成的一种引用数据类型。 数据类型分为基本数据类型和引用数据类型&#xff0c;引用数据类型分为类、接口、数组。要学习的内容 一维数组的声明、创建、初始化、元素的引用、长度。数组声明 语法格式&#xff1a; 数据类型[] 数组名; 数…
阅读更多...
卡尔曼滤波原理公式详细推导过程[包括引出]

卡尔曼滤波原理公式详细推导过程[包括引出]

卡尔曼滤波在很多项目中都有用到&#xff0c;但是对于原理却很少有详细分析&#xff0c;而只是直接应用&#xff0c;在看完b站up主DR_CAN视频推导后自行推导一遍和查看其他资料后进行总结&#xff0c;将从最初的递归算法&#xff0c;利用数据融合&#xff0c;协方差矩阵&#x…
阅读更多...
[vp] 2021 山东省赛 CDGHM

[vp] 2021 山东省赛 CDGHM

目录前言G. Grade Point Average ( 难度有先后)M. Matrix ProblemH. Adventurers GuildD.Dyson BoxC. Cat Virus前言 打满 2个小时30分钟 基本都在做题 体验非常好 传送门 : https://codeforces.com/gym/103118 G. Grade Point Average ( 难度有先后) 题意 : 让你求sum/ns…
阅读更多...
UG/NX二开Siemens官方实例解析 4.4 EX_Curve_ProjCurves(创建投影曲线)

UG/NX二开Siemens官方实例解析 4.4 EX_Curve_ProjCurves(创建投影曲线)

前言 本系列文章主要讲解NXOpen UF API&#xff08;简称ufun函数&#xff09;的使用&#xff0c;之前看教学视频大都建议用ufun进行开发&#xff0c;这里西门子官方还专门给了一套系列文章来讲&#xff0c;说明官方也是特别推崇ufun。 本人从事二开也有一段时间了&#xff0c;我…
阅读更多...
干货 | 测试人职场晋升“潜规则”：15 年经验资深测试经理的职场忠告

干货 | 测试人职场晋升“潜规则”：15 年经验资深测试经理的职场忠告

大家好&#xff0c;我是云胖虎&#xff0c;有近 15 年工作经验&#xff0c;在测试专业上擅长的方向是自动化测试&#xff0c;测试工具平台开发和探索测试相关的一些领域&#xff0c;也拿到过项目管理和敏捷教练的认证&#xff0c;目前是在某知名金融银行企业担任技术经理。今天…
阅读更多...
dataworks调度问题

dataworks调度问题

文章目录名词解释月调度关于空跑名词解释 业务日期 定时日期 - 1 自定义参数示例&#xff1a; 月调度 调度详情&#xff1a; 重要 使用补数据功能对月调度任务执行补数据操作时&#xff0c;请注意补数据选择的为业务日期 &#xff0c;业务日期定时调度日期-1。 例如&#xf…
阅读更多...
初始C++(一)

初始C++(一)

文章目录前言cout的用法cin的用法endl的用法一.命名空间1.:: (域作用限定符)2.命名空间定义3.命名空间的使用4.命名空间的一些其它使用5.全局展开6.部分展开二.缺省参数2.1全缺省2.2半缺省前言 既然这篇文章叫初始C&#xff0c;看我文章的应该和我一样&#xff0c;基本是个小白…
阅读更多...
React-Router6路由相关二（路由传参、编程式路由导航、路由相关hooks）（八）

React-Router6路由相关二（路由传参、编程式路由导航、路由相关hooks）（八）

系列文章目录 第一章&#xff1a;React基础知识&#xff08;React基本使用、JSX语法、React模块化与组件化&#xff09;&#xff08;一&#xff09; 第二章&#xff1a;React基础知识&#xff08;组件实例三大核心属性state、props、refs&#xff09;&#xff08;二&#xff0…
阅读更多...
ffmpeg vs2017录制vp9格式的桌面视频

ffmpeg vs2017录制vp9格式的桌面视频

ffmpeg本身不支持vp8,vp9&#xff1b;若要支持&#xff0c;则需要自己事先编译好vpx库&#xff0c;然后在ffmpeg中显式支持vpx库。 windows下采用mingw编译器编译vpx&#xff1b;本人采取的是MSYS2&#xff0c;并且本人编译vpx和ffmpeg时&#xff0c;编译的都是静态库&#xf…
阅读更多...
【云原生】在Ubuntu18/20上部署Kubernetes/k8s集群详细教程——亲测可用！！网上其他教程均有问题！

【云原生】在Ubuntu18/20上部署Kubernetes/k8s集群详细教程——亲测可用！！网上其他教程均有问题！

在Ubuntu18/20上部署Kubernetes/k8s详细教程一、设置Docker二、安装Kubernetes第 1 步&#xff1a;添加Kubernetes签名密钥第 2 步&#xff1a;添加软件存储库第 3 步&#xff1a;Kubernetes 安装工具三、部署 Kubernetes步骤 1&#xff1a;准备 Kubernetes 部署步骤 2&#xf…
阅读更多...
怎么找回笔记本的数据？笔记本数据恢复，6个教程

怎么找回笔记本的数据？笔记本数据恢复，6个教程

“我不小心删除了笔记本电脑里面的重要数据&#xff0c;请问被误删的数据还可以恢复吗&#xff1f;如果可以恢复&#xff0c;我应该怎么恢复笔记本里面的数据&#xff1f;” 很多人在使用笔记本电脑的时候&#xff0c;经常误删一些数据&#xff0c;有时是工作文档&#xff0c;…
阅读更多...
我是如何将同事的代码改成DDD风格的

我是如何将同事的代码改成DDD风格的

DDD是领域驱动设计的简写。前段时间听群友说行业里少有DDD的代码案例&#xff0c;进而对DDD没有一个感性的认识。我想这是行业里普遍存在的现象吧。所以&#xff0c;就有了写此文的想法。文章标题说的是“同事的代码”&#xff0c;其实只是为了让此文更具传播&#xff0c;没别的…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023