【C#】关于WCF你需要知道的！

虽然 WCF(Windows Communication Foundation) 已经不在是C#的最新技术，但很多老项目依然在用WCF。这边文章会让你快速知道WCF相关的知识。

1. 环境

以下是我的开发环境：

Visual Studio 2017

Dotnet framework 4.8

 

记得启动Windows Features.

 

 

 

2. 一个简单的WCF案例

微软提供了完整了WCF的文档，你可以从Windows Communication Foundation (WCF) samples 中微软的文档，也可以直接跳转到文档的Getting Started Sample。一步步的建好class文件，svc文件，以及web.config文件。

 

其中Web.config文件中的 endpoint 表示的是service的进入点，这个非常重要。如果没有给service配置endpoint的话， wcf就不知道暴漏出那些svc，service也就无法访问。

 

3. 使用Visual studio创建WCF

 这里我会使用Visual Studio 来创建一个WCF程序。

 然后你会看见项目文件IService1.cs, Service1.svc, Web.config

 Service1.svc文件内容，可以看出WcfService1.Service1的CodeBehind是Service1.svc.cs

而 Service1.svc.cs 有实现自 IService1.cs

 

 要运行起来可以按下F5,便可以运行

 然后会跳出WCF Test Client ，你就可以在这里测试你的WCF程序啦。

4. 使用WcfTestClient.exe程序来测试你的程序

如果你的Visual Studio 不是2017的话，你按F5很可能打不开WCF Test Client.  这时候你可以在你本地找到WcfTestClient.exe程序，然后手动打开进行测试。可以参考 WCF Test Client (WcfTestClient.exe)   WCFTestClient 的在每个人的本地有点不同，笔者本地可以在 C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\WcfTestClient.exe  目录下找到。

 

5. 通过Visual Studio 发布的WCF 直接部署到IIS上

通过  Visual Studio 发布后的WCF，在Web.config中是没有给Service配置Endpoint的。所以托管到IIS后，默认是可以打开的，但如果不能打开，可以配置endpoint。

 发布后的文件，

打开Web.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <appSettings>
    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
  </appSettings>
  <system.web>
    <compilation targetFramework="4.8" />
    <httpRuntime targetFramework="4.8" />
  </system.web>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <!-- To avoid disclosing metadata information, set the values below to false before deployment -->
          <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />
          <!-- To receive exception details in faults for debugging purposes, set the value below to true.  Set to false before deployment to avoid disclosing exception information -->
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <protocolMapping>
      <add binding="basicHttpsBinding" scheme="https" />
    </protocolMapping>
    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" multipleSiteBindingsEnabled="true" />
  </system.serviceModel>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true" />
    <!--
        To browse web app root directory during debugging, set the value below to true.
        Set to false before deployment to avoid disclosing web app folder information.
      -->
    <directoryBrowse enabled="true" />
  </system.webServer>
</configuration>
<!--ProjectGuid: 5E6D2C78-A51C-4AE4-9FB6-324936C66DCD-->

可以看出并没有给Service配置任何Endpoint, 部署到IS后，默认可以打开。

 如果你遇到Service无法访问，这时候可以手动给Web.config的Service加上endpoint, 显示指定让Service暴漏出去让网络可以访问。

 

 

然后需要配置Service 和 behavior

      <service
          name="WcfService1.IService1"
          behaviorConfiguration="TestServiceBehavior">
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>

需要注意IMetadadtaExchange是内置的contact类型，你可以直接使用。和hebavior

        <behavior name="TestServiceBehavior">
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>

更改后，完整的Web.config如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <appSettings>
    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
  </appSettings>
  <system.web>
    <compilation targetFramework="4.8" />
    <httpRuntime targetFramework="4.8" />
  </system.web>
  <system.serviceModel>
    <services>
      <service
          name="WcfService1.IService1"
          behaviorConfiguration="TestServiceBehavior">
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>


    <behaviors>
      <serviceBehaviors>
        <behavior name="TestServiceBehavior">
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>

        <behavior>
          <!-- To avoid disclosing metadata information, set the values below to false before deployment -->
          <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />
          <!-- To receive exception details in faults for debugging purposes, set the value below to true.  Set to false before deployment to avoid disclosing exception information -->
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
      </serviceBehaviors>
    </behaviors>

    <protocolMapping>
      <add binding="basicHttpsBinding" scheme="https" />
    </protocolMapping>

    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" multipleSiteBindingsEnabled="true" />

  </system.serviceModel>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true" />
    <!--
        To browse web app root directory during debugging, set the value below to true.
        Set to false before deployment to avoid disclosing web app folder information.
      -->
    <directoryBrowse enabled="true" />
  </system.webServer>
</configuration>
<!--ProjectGuid: 5E6D2C78-A51C-4AE4-9FB6-324936C66DCD-->