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 : System.String
Le nom du type d'identificateur.
- identifier
Type : array<System.Object[]
Un tableau de parties d'identificateur d'objet source de données.
- 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
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
- 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.