Partager via


DataObjectIdentifierResolver.ContractIdentifier, méthode

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 : System.String
    Le nom d'un objet de type de données.
  • fullIdentifier
    Type : array<System.Object[]
    Un identificateur complet d'un objet de données.
  • refresh
    Type : System.Boolean
    Une indication si toute contraction mise en cache doit être mis à jour.

Valeur de retour

Type : array<System.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

Voir aussi

Référence

DataObjectIdentifierResolver Classe

Microsoft.VisualStudio.Data, espace de noms

QuickExpandIdentifier

SlowExpandIdentifier