DataObjectItemComparer.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
Assembly :  Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.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 d'un type d'objet.

  • identifier
    Type : array<Object[]

    L'identificateur d'un objet du type spécifié par le paramètre d' typeName .

  • 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
Retourne inférieur à zéro dans les cas où la partie d'identificateur est inférieure à la valeur spécifiée.Retourne zéro si la partie d'identificateur est égale à la valeur spécifiée.Retourne la valeur supérieure à zéro si la plupart d'identificateur est que la valeur spécifiée.

Exceptions

Exception Condition
ArgumentNullException

Le paramètre d' typeName et/ou d' identifier est null.

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.

En passant l'identificateur de source complet, certaines situations complexes peuvent être gérées. 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 d'une table (qui apparaît comme les deuxième et troisième éléments 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 connaître qui 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. (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 la valeur false.

Cette méthode traite nullune référence null (Nothing en Visual Basic) et DBNull identique. Autrement dit, si une valeur est DBNull et l'autre valeur est nullune référence null (Nothing en Visual Basic), ils sont considérés comme la même valeur.

Sécurité .NET Framework

Voir aussi

Référence

DataObjectItemComparer Classe

Compare, surcharge

Microsoft.VisualStudio.Data, espace de noms