如何:创建调用 Web 服务的 UDF
本示例将演示如何从用户定义的函数 (UDF) 调用外部 Web 服务。本示例中使用 Web 服务是:
http://webservices.imacination.com/distance/Distance.jws?wsdl
您必须使用 Microsoft Visual Studio 2005 或类似的与 Microsoft .NET Framework 2.0 兼容的开发工具来创建此示例。
备注
测试代码之前,请确保您要调用的 Web 服务可用。Web 服务服务器可能已断开或 Web 服务已停止。如果 Web 服务不可用,您从代码向 Web 服务的调用将失败。
您可以通过访问 Web 服务的网站来检查该 Web 服务是否可用。在本示例中,URL 为:
http://webservices.imacination.com/distance/Distance.jws?wsdl
如果 Web 服务可用,您将能够看到 Web Services 描述语言 (WSDL)。如果 Web 服务不可用,通常会收到“未找到网页”错误消息。
示例
通过检查 Web 服务的 WSDL,您可以了解本示例中所使用的 Web 服务的更多相关信息。
所提供的一项服务是以小数形式返回地理位置坐标。在此示例中,已添加 ToDegreeNotation 函数,以演示如何将坐标转换为更适合显示坐标的度/分钟/秒。
[UdfMethod]
public string ToDegreeNotation(double angle)
{
int deg = (int)angle;
double minutesAndSeconds = Math.Abs(angle - deg) * 60;
int minutes = (int)minutesAndSeconds;
int seconds = (int)(Math.Abs(minutesAndSeconds - minutes) * 60);
return deg.ToString() + "°" + minutes.ToString() + "\'" +
seconds.ToString() + "\"";
}
如果您将 Internet Explorer LAN 设置配置为使用代理服务器,您的代码必须进行显式调用来设置代理服务器。否则 Web 服务调用将失败。可以在构造函数中设置代理服务器,如下所示:
namespace ZipCodeUdfSample
{
[UdfClass]
public class ZipCodeUdfs
{
DistanceService distanceService = null;
public ZipCodeUdfs()
{
this.distanceService = new DistanceService();
this.distanceService.Proxy =
new WebProxy("http://myproxy:80", true);
}
有关如何从单元格测试和调用 UDF 的详细信息,请参阅演练:开发托管代码 UDF。
using System;
using System.Collections.Generic;
using System.Text;
using System.Net;
using Microsoft.Office.Excel.Server.Udf;
using ZipCodes.com.imacination.webservices;
namespace ZipCodeUdfSample
{
[UdfClass]
public class ZipCodeUdfs
{
DistanceService distanceService = null;
public ZipCodeUdfs()
{
this.distanceService = new DistanceService();
//this.distanceService.Proxy = new WebProxy("http://myproxy:80", true);
}
[UdfMethod]
public double GetDistanceBetweenTwoZipCodes(int zip1, int zip2)
{
string zip1String = Convert.ToString(zip1);
string zip2String = Convert.ToString(zip2);
return (distanceService.getDistance(zip1String, zip2String));
}
[UdfMethod]
public string GetCityFromZip(int zip)
{
string zipString = Convert.ToString(zip);
return (distanceService.getCity(zipString));
}
[UdfMethod]
public string GetStateFromZip(int zip)
{
string zipString = Convert.ToString(zip);
return (distanceService.getState(zipString));
}
[UdfMethod]
public string GetLocationFromZip(int zip)
{
string zipString = Convert.ToString(zip);
return (distanceService.getLocation(zipString));
}
[UdfMethod]
public double GetLatitudeFromZip(int zip)
{
string zipString = Convert.ToString(zip);
return (distanceService.getLatitude(zipString));
}
[UdfMethod]
public double GetLongitudeFromZip(int zip)
{
string zipString = Convert.ToString(zip);
return (distanceService.getLongitude(zipString));
}
[UdfMethod]
public string ToDegreeNotation(double angle)
{
int deg = (int)angle;
double minutesAndSeconds = Math.Abs(angle - deg) * 60;
int minutes = (int)minutesAndSeconds;
int seconds = (int)(Math.Abs(minutesAndSeconds - minutes) * 60);
return deg.ToString() + "°" + minutes.ToString() + "\'" + seconds.ToString() + "\"";
}
}
}
See Also
任务
演练:使用 Excel Web Services 开发自定义应用程序