MetadataReference 類別

定義

命名空間:

System.ServiceModel.Description

組件:

System.ServiceModel.dll

表示從中繼資料交換端點傳回之中繼資料文件的參考。

public ref class MetadataReference : System::Xml::Serialization::IXmlSerializable

public class MetadataReference : System.Xml.Serialization.IXmlSerializable

type MetadataReference = class
    interface IXmlSerializable

Public Class MetadataReference
Implements IXmlSerializable

繼承

Object

MetadataReference

實作

IXmlSerializable

備註

使用 Windows Communication Foundation (WCF) 時，可以為任何服務建立中繼資料端點。 您可以查詢中繼資料的端點，以允許用戶端與端點通訊。 例如，中繼資料端點可以傳回描述服務的方法和資料型別的 Web 服務描述語言 (WSDL) 文件。

MetadataReference類別會搭配 WS-MetadataExchange 回應使用，其中參考會直接編碼為 <mex:MetadataReference> 或 <mex:MetadataLocation> 。

中繼資料文件可以參考很多其他描述型別的文件，而這些文件甚至可以包含更多的參考。 MetadataReference 類別代表單一端點，這個端點會傳回本身可包含多個 WSDL 或 XSD 項目，以及對其他 WS-MetadataExchange 端點之中繼資料參考的文件。

處理表示總中繼資料交換點的 MetadataReference 時，通常會使用 MetadataSet 類別的執行個體。 MetadataResolver 類別是針對解析所有用於傳回中繼資料的參考而設計。 但是，如果您需要檢查每個參考，請使用 MetadataReference 類別來表示每個端點。

規格

WCF 會針對傳回中繼資料，Exchange (透過 ws-metadataexchange) 規格來執行 Web 服務中繼資料。 該規格會進一步使用 Web 服務傳輸 (WS-Transfer) 規格來定義用於擷取 XML 資料的機制。

建構函式

MetadataReference()	初始化 MetadataReference 類別的新執行個體。
MetadataReference(EndpointAddress, AddressingVersion)	初始化 MetadataReference 類別的新執行個體，並且指定端點的網路位址和位址版本。

屬性

Address	取得或設定傳回中繼資料之服務的網路位址。
AddressVersion	取得或設定端點中實作或使用的版本。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IXmlSerializable.GetSchema()	傳回用於中繼資料參考端點的 XML 結構描述文件。
IXmlSerializable.ReadXml(XmlReader)	使用所提供的讀取器物件進行讀取。
IXmlSerializable.WriteXml(XmlWriter)	使用指定的寫入器物件寫入 XML 資料流。