DataObjectIdentifierResolver.ExpandIdentifier 方法

發行項
10/31/2012

展開資料物件的識別項與指定型別和部分的完整識別項和指示是否應該更新任何快取的展開 (Expansion)。

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

語法

'宣告
Public Overridable Function ExpandIdentifier ( _
    typeName As String, _
    partialIdentifier As Object(), _
    refresh As Boolean _
) As Object()

public virtual Object[] ExpandIdentifier(
    string typeName,
    Object[] partialIdentifier,
    bool refresh
)

public:
virtual array<Object^>^ ExpandIdentifier(
    String^ typeName, 
    array<Object^>^ partialIdentifier, 
    bool refresh
)

abstract ExpandIdentifier : 
        typeName:string * 
        partialIdentifier:Object[] * 
        refresh:bool -> Object[] 
override ExpandIdentifier : 
        typeName:string * 
        partialIdentifier:Object[] * 
        refresh:bool -> Object[]

public function ExpandIdentifier(
    typeName : String, 
    partialIdentifier : Object[], 
    refresh : boolean
) : Object[]

參數

typeName
型別：System.String
資料物件的型別名稱。

partialIdentifier
型別：array<System.Object[]
資料物件的部分識別項。

refresh
型別：System.Boolean
指示是否應該更新任何快取的展開 (Expansion)。

傳回值

型別：array<System.Object[]
傳回資料物件的完整，展開的識別項相符部分識別項傳遞，或 nullNull 參照 (即 Visual Basic 中的 Nothing) ，如果識別項無法展開。

例外狀況

例外狀況	條件
ArgumentNullException	typeName 參數為 null。

備註

使用這個方法會模擬資料來源如何展開識別項。因此，必須使用方法將解析度相同機制做為資料來源。如果輸入識別項都是資料來源的實際預期物件，這個方法會尋找該物件。如果不表示物件 (也就是說，如果它是為所建立的物件識別項)，則方法會預期的方式完成識別資料來源提供這類物件一樣。例如，在中，如果資料來源解析" CREATE TABLE 作者的作者為" pubs.dbo.authors」，則這個方法應該是相同的。

refresh 參數指出方法是否應該更新其快取反映目前資料來源的內容。這很可能是必要的資料來源內容連接中的存留期 (Lifetime) 期間，是否已變更。

提供者通常不會直接覆寫這個方法。基底實作會呼叫 QuickExpandIdentifier 和可能 SlowExpandIdentifier 方法，根據快取狀態。