MetadataExchangeClient 类

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.dll

下载服务元数据。

public ref class MetadataExchangeClient

public class MetadataExchangeClient

type MetadataExchangeClient = class

Public Class MetadataExchangeClient

继承

Object

MetadataExchangeClient

示例

下面的代码示例演示如何使用 MetadataExchangeClient 来指定下载绑定、解析任何包含的元数据引用以及下载元数据。

// Get metadata documents.
Console.WriteLine("URI of the metadata documents retreived:");
MetadataExchangeClient metaTransfer
  = new MetadataExchangeClient(httpGetMetaAddress.Uri, MetadataExchangeClientMode.HttpGet);
metaTransfer.ResolveMetadataReferences = true;
MetadataSet otherDocs = metaTransfer.GetMetadata();
foreach (MetadataSection doc in otherDocs.MetadataSections)
    Console.WriteLine(doc.Dialect + " : " + doc.Identifier);

注解

使用 MetadataExchangeClient 可以下载元数据。 通常，为元数据请求配置 MetadataExchangeClient，然后将其传递给 MetadataResolver.Resolve 或 MetadataResolver.Resolve 方法，以便 MetadataResolver 用于下载元数据。

但是，您可以直接使用 MetadataExchangeClient，以将元数据作为包含 MetadataSet 对象的 MetadataSection 进行检索。

无论是直接使用还是传递给 MetadataResolver，MetadataExchangeClient 均包含以下成员，以控制元数据下载过程：

• 使用构造函数可自定义发出元数据请求时要使用的绑定。

• 使用 HttpCredentials 属性可指定用于发出 HTTP/GET 请求的凭据。

• 使用 SoapCredentials 属性可指定用于发出 WS-Transfer 元数据请求的凭据。

• 使用 MaximumResolvedReferences 属性可限制 MetadataExchangeClient 所解析的元数据引用的数目。

• 使用 OperationTimeout 属性可限制检索元数据花费的时间。

• 使用 ResolveMetadataReferences 属性可指定是否要定位并检索由自原始元数据终结点下载的元数据所引用的其他元数据文档。

• 使用 GetMetadata 方法可开始下载过程。

此外，您还可以创建一个可重写以下两个受保护的方法的派生类：

• 重写 GetChannelFactory 方法可修改使用 WS-Transfer 发出元数据请求的信道。

• 重写 GetWebRequest 方法可修改使用 HTTP/GET 发出元数据请求的 HttpWebRequest。

构造函数

MetadataExchangeClient()	初始化 MetadataExchangeClient 类的新实例。
MetadataExchangeClient(Binding)	使用指定的绑定初始化 MetadataExchangeClient 类的新实例。
MetadataExchangeClient(EndpointAddress)	初始化 MetadataExchangeClient 类的新实例。
MetadataExchangeClient(String)	初始化 MetadataExchangeClient 类的新实例。
MetadataExchangeClient(Uri, MetadataExchangeClientMode)	初始化 MetadataExchangeClient 类的新实例。

属性

HttpCredentials	获取或设置用于发出 HTTP/GET 请求的凭据。
MaximumResolvedReferences	获取或设置对 MetadataExchangeClient 下载的元数据的引用的最大数目。
OperationTimeout	获取或设置一个时间段，必须在引发异常之前的此时间段内下载元数据。
ResolveMetadataReferences	获取或设置一个值，该值控制是否解析对元数据的引用。
SoapCredentials	获取或设置用于发出 WS-Transfer 元数据请求的客户端安全凭据。

方法

BeginGetMetadata(AsyncCallback, Object)	开始可返回 MetadataSet 的异步方法调用。
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	开始可使用指定地址、回调和异步状态返回 MetadataSet 的异步方法调用。
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	开始可使用指定地址、回调、异步状态和下载机制返回 MetadataSet 的异步方法调用。
EndGetMetadata(IAsyncResult)	结束可返回 MetadataSet 的异步方法调用。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetChannelFactory(EndpointAddress, String, String)	当在派生类中重写时，返回用于发出 WS-Transfer 元数据请求的通道工厂。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetMetadata()	返回 MetadataSet。
GetMetadata(EndpointAddress)	从指定的地址返回一个 MetadataSet。
GetMetadata(EndpointAddress, Uri)	从指定的地址和指定的路由返回 MetadataSet。
GetMetadata(Uri, MetadataExchangeClientMode)	使用指定的下载模式从指定的地址返回一个 MetadataSet。
GetMetadataAsync()	返回已设置的异步元数据。
GetMetadataAsync(EndpointAddress)	从指定的地址返回已设置的异步元数据。
GetMetadataAsync(EndpointAddress, Uri)	从指定的地址和指定的路由返回已设置的异步元数据。
GetMetadataAsync(Uri, MetadataExchangeClientMode)	使用指定的下载模式从指定的地址返回已设置的异步元数据
GetType()	获取当前实例的 Type。 (继承自 Object)
GetWebRequest(Uri, String, String)	当在派生类中重写时，返回用于发出 HTTP/GET 元数据请求的 HttpWebRequest。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)