Metodo DataObjectIdentifierResolver.ContractIdentifier

Articolo
10/30/2012

Contratto un identificatore per un oggetto dati al tipo specificato e identificatore completo e un'indicazione indipendentemente dal fatto che qualsiasi contrazione memorizzata nella cache deve essere aggiornata.

Spazio dei nomi: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Sintassi

'Dichiarazione
Public Overridable Function ContractIdentifier ( _
    typeName As String, _
    fullIdentifier As Object(), _
    refresh As Boolean _
) As Object()

public virtual Object[] ContractIdentifier(
    string typeName,
    Object[] fullIdentifier,
    bool refresh
)

public:
virtual array<Object^>^ ContractIdentifier(
    String^ typeName, 
    array<Object^>^ fullIdentifier, 
    bool refresh
)

abstract ContractIdentifier : 
        typeName:string * 
        fullIdentifier:Object[] * 
        refresh:bool -> Object[] 
override ContractIdentifier : 
        typeName:string * 
        fullIdentifier:Object[] * 
        refresh:bool -> Object[]

public function ContractIdentifier(
    typeName : String, 
    fullIdentifier : Object[], 
    refresh : boolean
) : Object[]

Parametri

typeName
Tipo: System.String
Il nome di un tipo di oggetto dati.

fullIdentifier
Tipo: array<System.Object[]
Un identificatore completo di un oggetto dati.

refresh
Tipo: System.Boolean
Oggetto che indica se qualsiasi contrazione memorizzata nella cache deve essere aggiornata.

Valore restituito

Tipo: array<System.Object[]
Restituisce la parziale, identificatore univoco contratto per un oggetto dati.

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro typeName è null.

Note

Utilizzare questo metodo per accettare un identificatore completo e convertirlo in più piccolo identificatore ancora possibile identificare in modo univoco l'oggetto.Ad esempio su SQL Server, una volta effettuato l'accesso come utente dbo a pub di database, un identificatore completo "pubs.dbo.authors" può essere contratto a forma più semplice, "autori".

Il parametro refresh indica se il metodo deve aggiornare la cache per riflettere il contesto corrente dell'origine dati.Ciò è necessario molto probabilmente se le modifiche del contesto di origine dati durante l'esecuzione di una connessione.

Generalmente un provider di dati non esegue l'override di questo metodo.L'implementazione di base trasforma le chiamate a QuickContractIdentifier ed eventualmente il metodo SlowContractIdentifier, a seconda dello stato della cache.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.