DSRefBuilder 類別

可讓您建立可識別一個資料物件的資料來源參考 (DSRef) 物件。

繼承階層架構

Object
  Microsoft.VisualStudio.Data.ObjectWithSite
    Microsoft.VisualStudio.Data.DSRefBuilder

命名空間：  Microsoft.VisualStudio.Data
組件：  Microsoft.VisualStudio.Data (在 Microsoft.VisualStudio.Data.dll 中)

語法

'宣告
<GuidAttribute("D42D21CE-A94A-47f2-A2DA-ACE133020BCD")> _
Public Class DSRefBuilder _
    Inherits ObjectWithSite

[GuidAttribute("D42D21CE-A94A-47f2-A2DA-ACE133020BCD")]
public class DSRefBuilder : ObjectWithSite

[GuidAttribute(L"D42D21CE-A94A-47f2-A2DA-ACE133020BCD")]
public ref class DSRefBuilder : public ObjectWithSite

[<GuidAttribute("D42D21CE-A94A-47f2-A2DA-ACE133020BCD")>]
type DSRefBuilder =  
    class 
        inherit ObjectWithSite 
    end

public class DSRefBuilder extends ObjectWithSite

DSRefBuilder 類型會公開下列成員。

建構函式

	名稱	描述
	DSRefBuilder	類別建構函式的建構函式。初始化 DSRefBuilder 類別的新執行個體。

回頁首

屬性

	名稱	描述
	Connection	擷取資料來源連接， DataConnection 物件執行個體。
	Site	擷取或設定物件站台。 (繼承自 ObjectWithSite)。

回頁首

方法

	名稱	描述
	AppendToDSRef	如需附加資訊至具有指定型別和識別項的訊息至指定的現有 DSRef 物件。
	BuildDSRef	建立具有指定之識別型別和識別項的一個資料物件的 DSRef 物件。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	在記憶體回收開始前，允許物件嘗試釋放資源，並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	OnSiteChanged	引發 SiteChanged 事件。 (繼承自 ObjectWithSite)。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

事件

	名稱	描述
	SiteChanged	引發事件，在變更 Site 屬性。 (繼承自 ObjectWithSite)。

回頁首

明確介面實作

	名稱	描述
	IObjectWithSite.GetSite	擷取 IObjectWithSite.SetSite 使用方法設定的最後一個網站。在沒有已知的網站時，物件會傳回例外狀況。 (繼承自 ObjectWithSite)。
	IObjectWithSite.SetSite	提供網站的指標的站台物件。 (繼承自 ObjectWithSite)。

回頁首

備註

這個類別在資料提供者的資料物件支援 XML 檔會使用所提供的資訊建立物件 DSRef 啟用拖放作業。

當指定 BuildDSRef 動作，資料提供者應附加至特定參數指出應建立哪些節點，以及哪一個識別項不同地區的應該用來做為值的節點。 這些參數的格式如下。

• 參數 1:節點的名稱。

• 參數 2:節點的擁有人。

• 參數 3:節點型別 (資料表、欄位、資料庫、觸發程序、StoredProcedure、檢視、同義資料表 (Synonym)、函式或索引)。

• 參數 4:節點的擴充的型別。

• 參數 5:在值為自訂屬性和內嵌參數的 GUID 的子參數指定的自訂屬性的集合包含值。

• 參數 6:當子參數指定的子節點的集合。

在這個類別無法完全適用於您的資料提供者的服務需求時，您可以從它繼承和指定您的類別，不過，在許多情況下就不是必要的。 不過，在這種情況下，資料提供者必須實作自訂 DSRef 建置機制處理， DSRefBuilder 類別為您提供這項功能。

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data 命名空間