DataObjectItemComparer.Compare - метод (String, array<Object , Int32, Object)
Сравнивает одну часть идентификатора объекта с другой частью идентификатора указанного объекта.
Пространство имен: Microsoft.VisualStudio.Data
Сборка: Microsoft.VisualStudio.Data (в Microsoft.VisualStudio.Data.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[]
Идентификатор объекта типа, указанного в параметре typeName.
- identifierPart
Тип: System.Int32
Нуля индекс в массиве, указывающий на основе идентификатора, которая является частью идентификатора для сравнения.
- value
Тип: System.Object
Значение для сравнения часть идентификатора.
Возвращаемое значение
Тип: System.Int32
Возвращает меньше нуля, в тех случаях, когда часть идентификатора меньше указанного значения.Возвращает нуль, если часть идентификатора равна заданному значению.Возвращает больше нуля, если часть идентификатора больше указанного значения.
Исключения
Исключение | Условие |
---|---|
ArgumentNullException | Параметр typeName и/или identifier значение null. |
ArgumentOutOfRangeException | Параметр identifier меньше нуля или больше или равно количеству элементов в массиве идентификаторов. |
Заметки
Этот метод должен использовать те же правила сравнения, что и источник данных для обеспечения правильной уникальность объектов на стороне клиента.
Путем передачи полный идентификатор источника, некоторые сложные ситуации можно устранить.Например, последние версии Microsoft SQL Server позволяет серверу в целом, чтобы учитываться регистр при сравнении, а указанная база данных на сервере может учитываться нечувствительным или наоборот идентификатора.Это означает, что при сравнении схем или имя таблицы (который отображается как второй и третий элементы в полном идентификатор таблицы, в первой части быть базой данных), реализация данного метода должна использоваться первая часть идентификатора в давати в числовом выражении, база данных, таблица, и, таким образом, что тип сравнения, которое необходимо использовать.
Базовая реализация этого метода используется компаратор объекта значения по умолчанию .NET (Comparer), если часть идентификатора инициатора будет реализовывать IComparable; в противном случае он вызывает метод Equals переопределения реализации IComparable и возвращает 1, если этот метод возвращает значение false.
Этот метод обрабатывает nullссылка NULL (Nothing в Visual Basic) и DBNull одинаково.То есть, если одно значение DBNull и другое значение nullссылка NULL (Nothing в Visual Basic), они считаются одно и то же значение.
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.