DataObjectItemComparer.Compare-Methode (String, array<Object[], Int32, Object)

Artikel
05/16/2015

Vergleicht einen Objektkennungsteil mit einem anderen angegebenen Objektkennungsteil.

Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Syntax

'Declaration
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

Parameter

typeName
Typ: String

Der Name eines Objekttyps.

identifier
Typ: array<Object[]

Der Bezeichner eines Objekts vom Typ angegeben durch typeName-Parameter.

identifierPart
Typ: Int32

Der nullbasierte Index im Bezeichnerarray, das das Teil des Bezeichners angibt, um zu vergleichen.

value
Typ: Object

Ein Wert, mit dem das Bezeichnerteils für zu vergleichen.

Rückgabewert

Typ: Int32
Gibt kleiner als null zurück, wenn der Bezeichnerteil kleiner als der angegebene Wert ist.Gibt null zurück, wenn der Bezeichnerteil gleich dem angegebenen Wert ist.Gibt größer als null zurück, wenn der Bezeichnerteil größer als der angegebene Wert ist.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der typeName und/oder identifier-Parameter ist NULL.
ArgumentOutOfRangeException	Der identifier-Parameter ist kleiner als null oder größer oder gleich der Anzahl von Elementen im Bezeichnerarray.

Hinweise

Diese Methode sollte die gleichen Vergleichsregeln als Datenquelle verwenden, die richtige Eindeutigkeit von Objekten auf der Clientseite sicherzustellen.

Wenn Sie in die vollständige Absenderkennung übergibt, können bestimmte komplexe Situationen behandelt werden. Beispielsweise gestatten neue Versionen von Microsoft SQL Server dem Server insgesamt, um auf Bezeichnervergleich Groß-/Kleinschreibung sein, während eine bestimmte Datenbank auf dem Server möglicherweise die Groß-/Kleinschreibung nicht beachtet wird, oder umgekehrt. Dies bedeutet, dass, wenn sie das Schema oder Name einer Tabelle (das als die zweite und dritte Teile in einem vollständigen in angezeigt wird, den ersten Teil, die die Datenbank ist) vergleicht, die Implementierung dieser Methode den ersten Bezeichnerteil verwenden muss, um out, die Datenbank die Tabelle befindet, und damit darzustellen, welche Art von Vergleich zu verwenden.

Die Basisimplementierung dieser Methode verwendet den standardmäßigen .NET-Objektvergleich (Comparer) wenn der Absenderkennungsteil IComparable implementiert; andernfalls ruft sie die Equals-Überschreibungsmethode der IComparable-Implementierung auf und gibt 1 zurück, wenn diese Methode false zurückgibt.

Diese Methode behandelt nullein Nullverweis (Nothing in Visual Basic) und DBNull identisch. Das heißt, wenn ein Wert DBNull ist und der andere Wert nullein Nullverweis (Nothing in Visual Basic) ist, werden sie der gleiche Wert betrachtet.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

DataObjectItemComparer Klasse

Compare-Überladung

Microsoft.VisualStudio.Data-Namespace

Freigeben über