DataObjectMemberComparer.Compare - метод (String, array<Object , Int32, Object)

Статья
11/01/2012

Сравнивает одну часть идентификатора объекта с другой частью идентификатора указанного объекта.

Пространство имен: Microsoft.VisualStudio.Data.Framework
Сборка: Microsoft.VisualStudio.Data.Framework (в Microsoft.VisualStudio.Data.Framework.dll)

Синтаксис

'Декларация
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

Параметры

typeName
Тип: System.String
Имя типа идентификатора.

identifier
Тип: array<System.Object[]
Массив частей идентификатора объекта источника данных.

identifierPart
Тип: System.Int32
Индекс, начинающийся с нуля в массиве идентификаторов, указывающее, которые являются частью идентификатора для сравнения.

value
Тип: System.Object
Значение для сравнения часть идентификатора.

Возвращаемое значение

Тип: System.Int32
Значение меньше нуля, если часть идентификатора меньше указанного значения; нуль, если часть идентификатора равна заданному значению. значение больше нуля, если часть идентификатора больше указанного значения.

Реализации

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

Исключения

Исключение	Условие
ArgumentNullException	Параметр typeName и/или identifiernullссылка NULL (Nothing в Visual Basic).
ArgumentOutOfRangeException	Параметр identifier меньше нуля или больше или равно количеству элементов в массиве идентификаторов.

Заметки

Этот метод должен использовать те же правила сравнения, что и источник данных для обеспечения правильной уникальность объектов на стороне клиента.

Если передается в полный идентификатор источника, то можно обрабатывать некоторые сложные ситуации.Например, последние версии Microsoft SQL Server позволяет серверу в целом, чтобы учитываться регистр при сравнении, а указанная база данных на сервере может учитываться нечувствительным или наоборот идентификатора.Это означает, что при сравнении схем или имя таблицы (которой отображаются как второе и третье части соответственно в полном идентификатор таблицы, первая часть быть базой данных), реализации этого метода должны использовать первую часть идентификатора для задания, база данных, таблица, и, таким образом, что тип сравнения, которое необходимо использовать.

Базовая реализация этого метода по умолчанию использует сравнения объектов платформы .NET Framework (Comparer), если часть идентификатора инициатора будет реализовывать IComparable; в противном случае он вызывает метод Equals переопределения реализации IComparable и возвращает 1, если этот метод возвращает false.

Этот метод обрабатывает значение null и DBNull одинаково.То есть, если одно значение DBNull и другое значение равно null, они рассматриваются одно и то же значение.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.