DataObjectMemberComparer.Compare, méthode (String, array<Object[], Int32, Object)

Compare une partie d'identificateur d'objet à une autre partie spécifiée d'identificateur d'objet.

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

Syntaxe

'Déclaration
Public Overridable Function Compare ( _
    typeName As String, _
    identifier As Object(), _
    identifierPart As Integer, _
    value As Object _
) As Integer
public virtual int Compare(
    string typeName,
    Object[] identifier,
    int identifierPart,
    Object value
)
public:
virtual int Compare(
    String^ typeName, 
    array<Object^>^ identifier, 
    int identifierPart, 
    Object^ value
)
abstract Compare : 
        typeName:string * 
        identifier:Object[] * 
        identifierPart:int * 
        value:Object -> int  
override Compare : 
        typeName:string * 
        identifier:Object[] * 
        identifierPart:int * 
        value:Object -> int
public function Compare(
    typeName : String, 
    identifier : Object[], 
    identifierPart : int, 
    value : Object
) : int

Paramètres

  • typeName
    Type : String

    Le nom du type d'identificateur.

  • identifier
    Type : array<Object[]

    Un tableau de parties d'identificateur d'objet source de données.

  • identifierPart
    Type : Int32

    L'index de base zéro dans le tableau d'identificateurs indiquant qu'une partie de l'identificateur à comparer.

  • value
    Type : Object

    Une valeur pour comparer la partie d'identificateur sur.

Valeur de retour

Type : Int32
Une valeur inférieure de zéro si la partie d'identificateur est inférieure à la valeur spécifiée ; zéro si la partie d'identificateur est égale à la valeur spécifiée ; une valeur supérieure à zéro si la plupart d'identificateur est que la valeur spécifiée.

Implémentations

IVsDataObjectMemberComparer.Compare(String, array<Object[], Int32, Object)

Exceptions

Exception Condition
ArgumentNullException

Le paramètre d' typeName et/ou d' identifier est nullune référence null (Nothing en Visual Basic).

ArgumentOutOfRangeException

Le paramètre d' identifier est inférieur à zéro ou supérieur ou égal au nombre d'éléments du tableau d'identificateurs.

Notes

Cette méthode doit utiliser les mêmes règles de comparaison que la source de données pour garantir l'unicité correcte des objets côté client.

Si vous passez l'identificateur de source complet, vous pouvez gérer certaines situations complexes. Par exemple, les versions récentes de Microsoft SQL Server permettront au serveur dans son ensemble pour distinguer la casse sur la comparaison d'identificateur pendant qu'une base de données particulière sur le serveur peut être respecte pas la casse, ou vice versa. Cela signifie qu'en comparant le schéma ou le nom d'une table (qui apparaissent comme le deuxième et le troisième parties respectivement dans un identificateur du tableau complet, la première partie de la base de données), l'implémentation de cette méthode doit utiliser la première partie d'identificateur pour déterminer la base de données la table est dans, et donc, que le type de comparaison à utiliser.

L'implémentation de base de cette méthode utilise le comparateur par défaut d'objet.NET Framework (Comparer) lorsque la pièce d'identificateur de source implémente IComparable; sinon elle appelle la méthode d' Equals de la priorité de l'implémentation d' IComparable et retourne 1 si cette méthode retourne false.

Cette méthode traite null et DBNull identique. Autrement dit, si une valeur est DBNull et l'autre valeur est null, ils sont considérés comme la même valeur.

Sécurité .NET Framework

Voir aussi

Référence

DataObjectMemberComparer Classe

Compare, surcharge

Microsoft.VisualStudio.Data.Framework, espace de noms