DataObjectIdentifierConverter 類別

提供轉換特定資料來源的物件識別項從字串至識別項組件和從識別項至字串。

繼承階層架構

System.Object
  Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataObjectIdentifierConverter
      Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetObjectIdentifierConverter

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

語法

'宣告
Public MustInherit Class DataObjectIdentifierConverter _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataObjectIdentifierConverter

public abstract class DataObjectIdentifierConverter : DataSiteableObject<IVsDataConnection>, 
    IVsDataObjectIdentifierConverter

public ref class DataObjectIdentifierConverter abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataObjectIdentifierConverter

[<AbstractClass>]
type DataObjectIdentifierConverter =  
    class
        inherit DataSiteableObject<IVsDataConnection>
        interface IVsDataObjectIdentifierConverter
    end

public abstract class DataObjectIdentifierConverter extends DataSiteableObject<IVsDataConnection> implements IVsDataObjectIdentifierConverter

DataObjectIdentifierConverter 型別會公開下列成員。

建構函式

	名稱	說明
	DataObjectIdentifierConverter()	初始化 DataObjectIdentifierConverter 類別的新執行個體。
	DataObjectIdentifierConverter(IVsDataConnection)	初始化類別的 DataObjectIdentifierConverter 一個參數化的執行個體，指定資料連接物件。

回頁首

屬性

	名稱	說明
	Site	取得或設定物件的網站。 (繼承自 DataSiteableObject<T>)。

回頁首

方法

	名稱	說明
	BuildString	建立識別項的字串版本。
	ConvertToArray	將格式化的字串識別項編碼成其對等的一組識別組件。
	ConvertToString(String, array<Object[])	將一組識別組件至格式化字串識別項。
	ConvertToString(String, array<Object[], DataObjectIdentifierFormat)	使用指定的格式化選項，將一組識別組件至格式化字串識別項。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	FormatPart	格式化的指定識別項的組件。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	OnSiteChanged	引發 SiteChanged 事件。 (繼承自 DataSiteableObject<T>)。
	SplitIntoParts	區分識別項的字串版本 (由一組識別組件轉換成所要的格式。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。
	UnformatPart	移除格式套用到指定的組件識別。

回頁首

事件

	名稱	說明
	SiteChanged	在 Site 屬性變更時發生。 (繼承自 DataSiteableObject<T>)。

回頁首

備註

通常，中的物件識別項在資料來源中包含用於命令所執行的字串。例如，在 SQL 陳述式 SELECT * FROM mytable，字串 mytable 做為物件的唯一識別項在下一個陳述式執行的內容。

通常是資料來源具有物件的內含機制，例如目錄、結構描述或封裝。因為單一名稱可唯一識別物件，不再滿足要求此介紹多部分識別項的需求。例如，在不同的使用者執行的 Oracle 伺服器的不同物件，讓物件的唯一識別項限定使用者名稱。

由於格式的這種多重區段識別項可以從資料來源變更為另一個，必須能夠將指定字串轉換成它的一部分 (反之亦然)。這個類別會提供這類的機制。

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.Data.Framework 命名空間

DataObjectIdentifierResolver