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 : System.String
Le nom d'un type d'objet.
- identifier
Type : array<System.Object[]
L'identificateur d'un objet du type spécifié par le paramètre d' typeName .
- identifierPart
Type : System.Int32
L'index de base zéro dans le tableau d'identificateurs indiquant qu'une partie de l'identificateur à comparer.
- value
Type : System.Object
Une valeur pour comparer la partie d'identificateur sur.
Valeur de retour
Type : System.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
- 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.