本主题说明如何使 Windows Communication Foundation (WCF) 服务可发现。 它基于自托管示例。
针对 Discovery 配置现有自承载服务示例
-
在 Visual Studio 2012 中打开自承载解决方案。 示例位于 TechnologySamples\Basic\Service\Hosting\SelfHost 目录中。
-
将对
System.ServiceModel.Discovery.dll的引用添加到服务项目中。 可能会看到错误消息,指出"系统。 ServiceModel.Discovery.dll 或其某个依赖项需要更高版本的.NET framework 与指定的项目中..."如果看到此消息,请右键单击解决方案资源管理器中的项目并选择属性。 在中项目属性窗口中,请确保目标框架是.NET Framework 4.6.1。 -
打开 Service.cs 文件并添加下面的
using语句。using System.ServiceModel.Discovery; -
在
Main()方法的using语句内部,将一个 xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior 实例添加到服务主机中。public static void Main() { // Create a ServiceHost for the CalculatorService type. using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService))) { // Add a ServiceDiscoveryBehavior serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior()); // ... } }xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior 指定自身应用到的服务可供检测。
-
将 xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint 添加到服务主机中,位置紧随添加 xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior 的代码之后。
// Add ServiceDiscoveryBehavior serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior()); // Add a UdpDiscoveryEndpoint serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());此代码指定应将发现消息发送到标准 UDP 发现终结点。
创建使用发现功能调用服务的客户端应用程序
-
向名为
DiscoveryClientApp的解决方案添加一个新控制台应用程序。 -
添加对
System.ServiceModel.dll和System.ServiceModel.Discovery.dll的引用 -
将 GeneratedClient.cs 和 App.config 文件从现有客户端项目复制到新的 DiscoveryClientApp 项目。 若要执行此操作,右键单击中的文件解决方案资源管理器,选择副本,然后选择DiscoveryClientApp项目中,右键单击,然后选择粘贴。
-
打开 Program.cs。
-
添加下面的
using语句。using System.ServiceModel; using System.ServiceModel.Discovery; using Microsoft.ServiceModel.Samples; -
将一个名为
FindCalculatorServiceAddress()的静态方法添加到Program类。static EndpointAddress FindCalculatorServiceAddress() { }此方法使用发现功能搜索
CalculatorService服务。 -
在
FindCalculatorServiceAddress方法内部,创建新 xref:System.ServiceModel.Discovery.DiscoveryClient 实例,以将 xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint 传递给构造函数。static EndpointAddress FindCalculatorServiceAddress() { // Create DiscoveryClient DiscoveryClient discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint()); }这将告知 WCF 的xref:System.ServiceModel.Discovery.DiscoveryClient类应使用标准 UDP 发现终结点发送和接收发现消息。
-
在下一行,调用 xref:System.ServiceModel.Discovery.DiscoveryClient.Find* 方法并指定包含要搜索的服务协定的 xref:System.ServiceModel.Discovery.FindCriteria 实例。 在本示例中,指定的是
ICalculator。// Find ICalculatorService endpoints FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculator))); -
调用 xref:System.ServiceModel.Discovery.DiscoveryClient.Find* 之后,查看是否至少有一个匹配服务,然后返回第一个匹配服务的 xref:System.ServiceModel.EndpointAddress。 如果找不到匹配服务,则返回
null。if (findResponse.Endpoints.Count > 0) { return findResponse.Endpoints[0].Address; } else { return null; } -
将名为
InvokeCalculatorService的静态方法添加到Program类。static void InvokeCalculatorService(EndpointAddress endpointAddress) { }此方法使用从
FindCalculatorServiceAddress返回的终结点地址调用计算器服务。 -
在
InvokeCalculatorService方法的内部,创建CalculatorServiceClient类的实例。 此类定义由自托管示例。 并且是使用 Svcutil.exe 生成的。// Create a client CalculatorClient client = new CalculatorClient(); -
在下一行,将客户端的终结点地址设置为从
FindCalculatorServiceAddress()返回的终结点地址。// Connect to the discovered service endpoint client.Endpoint.Address = endpointAddress; -
紧随上一步骤的代码之后,调用由计算器服务公开的方法。
Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress); double value1 = 100.00D; double value2 = 15.99D; // Call the Add service operation. double result = client.Add(value1, value2); Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result); // Call the Subtract service operation. result = client.Subtract(value1, value2); Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result); // Call the Multiply service operation. result = client.Multiply(value1, value2); Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result); // Call the Divide service operation. result = client.Divide(value1, value2); Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result); Console.WriteLine(); //Closing the client gracefully closes the connection and cleans up resources client.Close(); -
将以下代码添加到
Main()类中的Program方法以调用FindCalculatorServiceAddress。public static void Main() { EndpointAddress endpointAddress = FindCalculatorServiceAddress(); } -
在下一行,调用
InvokeCalculatorService(),并传递由FindCalculatorServiceAddress()返回的终结点地址。if (endpointAddress != null) { InvokeCalculatorService(endpointAddress); } Console.WriteLine("Press <ENTER> to exit."); Console.ReadLine();
测试应用程序
-
打开具有特权的命令提示符并运行 Service.exe。
-
打开命令提示符并运行 Discoveryclientapp.exe。
-
service.exe 的输出应类似于以下输出。
Received Add(100,15.99) Return: 115.99 Received Subtract(100,15.99) Return: 84.01 Received Multiply(100,15.99) Return: 1599 Received Divide(100,15.99) Return: 6.25390869293308 -
Discoveryclientapp.exe 的输出应类似于以下输出。
Invoking CalculatorService at http://localhost:8000/ServiceModelSamples/service Add(100,15.99) = 115.99 Subtract(100,15.99) = 84.01 Multiply(100,15.99) = 1599 Divide(100,15.99) = 6.25390869293308 Press <ENTER> to exit.
示例
下面是此示例的代码清单。 因为此代码基于自托管示例列出了这些文件进行的更改。 有关自承载示例的详细信息,请参阅设置说明。
// Service.cs
using System;
using System.Configuration;
using System.ServiceModel;
using System.ServiceModel.Discovery;
namespace Microsoft.ServiceModel.Samples
{
// See SelfHost sample for service contract and implementation
// ...
// Host the service within this EXE console application.
public static void Main()
{
// Create a ServiceHost for the CalculatorService type.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
// Add the ServiceDiscoveryBehavior to make the service discoverable
serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());
serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());
// Open the ServiceHost to create listeners and start listening for messages.
serviceHost.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
}
}
}
}
// Program.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.ServiceModel;
using System.ServiceModel.Discovery;
using Microsoft.ServiceModel.Samples;
using System.Text;
namespace DiscoveryClientApp
{
class Program
{
static EndpointAddress FindCalculatorServiceAddress()
{
// Create DiscoveryClient
DiscoveryClient discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint());
// Find ICalculatorService endpoints
FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculator)));
if (findResponse.Endpoints.Count > 0)
{
return findResponse.Endpoints[0].Address;
}
else
{
return null;
}
}
static void InvokeCalculatorService(EndpointAddress endpointAddress)
{
// Create a client
CalculatorClient client = new CalculatorClient();
// Connect to the discovered service endpoint
client.Endpoint.Address = endpointAddress;
Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress);
double value1 = 100.00D;
double value2 = 15.99D;
// Call the Add service operation.
double result = client.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);
// Call the Subtract service operation.
result = client.Subtract(value1, value2);
Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);
// Call the Multiply service operation.
result = client.Multiply(value1, value2);
Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);
// Call the Divide service operation.
result = client.Divide(value1, value2);
Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);
Console.WriteLine();
//Closing the client gracefully closes the connection and cleans up resources
client.Close();
}
static void Main(string[] args)
{
EndpointAddress endpointAddress = FindCalculatorServiceAddress();
if (endpointAddress != null)
{
InvokeCalculatorService(endpointAddress);
}
Console.WriteLine("Press <ENTER> to exit.");
Console.ReadLine();
}
}
}
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
