DataObjectIdentifierConverter 類別

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

繼承階層架構

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