DataObjectIdentifierResolver.ContractIdentifier, méthode

Article
05/16/2015

Contracte un identificateur pour un objet de données avec le type spécifié et identificateur complet et une indication si toute contraction mise en cache doit être mis à jour.

Espace de noms : Microsoft.VisualStudio.Data
Assembly : Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)

Syntaxe

'Déclaration
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[]

Paramètres

typeName
Type : String

Le nom d'un objet de type de données.

fullIdentifier
Type : array<Object[]

Un identificateur complet d'un objet de données.

refresh
Type : Boolean

Une indication si toute contraction mise en cache doit être mis à jour.

Valeur de retour

Type : array<Object[]
Retourne l'identificateur unique partiel et contracté pour un objet de données.

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre typeName est null.

Notes

Utilisez cette méthode pour prendre un identificateur complet et le convertir en plus petit identificateur qui identifie toujours uniquement l'objet. Par exemple sur SQL Server, si connecté en tant qu'utilisateur aux dbo pubs de base de données, un identificateur complet « pubs.dbo.authors » peut être contracté au formulaire plus simple, « auteurs ».

Le paramètre d' refresh indique si la méthode doit mettre à jour son cache pour refléter le contexte actuel de source de données. Il s'agit probablement nécessaire si le contexte de source de données change pendant la durée de vie d'une connexion.

Normalement un fournisseur de données ne substituerait pas cette méthode directement. L'implémentation de base transforme des appels en QuickContractIdentifier et éventuellement méthode d' SlowContractIdentifier, selon l'état de cache.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.