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)