述引用在一个发现文档中通过使用http://schemas.xmlsoap.org/disco/scl/ XML域名空间添加一个<contractRef>元素来指定。同样地,对其它的发现文档和XSD模式的引用分别通过添加<discoveryRef>和<schemaRef> XML元素来指定。对于XSD模式引用,必须指定XML域名空间http://schemas.xmlsoap.org/disco/schema。。下面的代码示例有对于发现文档、服务描述和一个XSD模式的引用。
<?xml version="1.0"?> <discovery xmlns="http://schemas.xmlsoap.org/disco/"> <discoveryRef ref="/Folder/Default.disco"/> <contractRef ref="http://MyWebServer/UserName.asmx?WSDL" docRef="Service.htm" xmlns="http://schemas.xmlsoap.org/disco/scl/"/> <schemaRef ref="Schema.xsd" xmlns="http://schemas.xmlsoap.org/disco/schema/"/> </discovery> |
引用可以与发现文档存在于的目录有关,就如在discoveryRef元素所示,或与一个URI有关,就如在contractRef元素所示。
通过复制发现文档到Web服务器的一个虚拟目录下,把发现文档部署到这台Web服务器上。
选择性地,如果你想要通过指定一个IIS应用程序而不需要指定一个文档来允许预期消耗者导航到一个URL,那么你可以添加一个到IIS应用程序的默认的页面。这对预期消耗者有益,他们不必知道任意发现文档的名称。用户可以提供想下面发现过程中的URL:
http://MyWebServer/MyWebApplication
如果用于Web应用程序的默认页面是一个HTML页面:
在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的标记到默认的Web页面中。
<HEAD> <link type=''text/xml'' rel=''alternate'' href=''MyWebService.disco''/> </HEAD> |
如果用于Web应用程序的默认页面是一个XML文档:
在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的代码到默认的Web页面的顶端。
<?xml-stylesheet type="text/xml" alternate="yes" href="MyWebService.disco" ?> |
选择性地,如果你使用Visual Studio.NET,你可以开启动态的发现来允许XML Web服务客户端应用程序来在一个没有创建发现文档的Web服务器上发现可用的XML Web服务。当动态发现开启的时候,客户应用程序在Add Web Reference对话框中指定一个引用带有.vsdisco部分的文件的URL,例如www.contoso.com/default.vsdisco,来代替特定的发现文档。
为了开启用于一个Web服务器的动态发现,要修改machine.config来添加下面的<add>元素。
<configuration> <system.web> <httpHandlers> <add verb="*" path="*.vsdisco" type="System.Web.Services.Discovery.DiscoveryRequestHandler, System.Web.Services, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" validate="false"/> </httpHandlers> </system.web> </configuration> |