DataObjectItemComparer.Compare (Método) (String, array<Object[], Int32, Object)

Compara una parte del identificador de objeto con otra partición especificada del identificador de objeto.

Espacio de nombres:  Microsoft.VisualStudio.Data
Ensamblado:  Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)

Sintaxis

'Declaración
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

Parámetros

• typeName
  Tipo: String

  El nombre de un tipo de objeto.

• identifier
  Tipo: array<Object[]

  El identificador de un objeto del tipo especificado por el parámetro de typeName .

• identifierPart
  Tipo: Int32

  El cero índice basándose en la matriz de identificadores que indica qué parte del identificador para comparar.

• value
  Tipo: Object

  Un valor para comparar la parte del identificador en.

Valor devuelto

Tipo: Int32
Devuelve menos de cero en caso de que la parte del identificador menor que el valor especificado.Devuelve cero si la parte del identificador es igual al valor especificado.Vuelve mayor que cero si el elemento ID es mayor que el valor especificado.

Excepciones

Excepción	Condición
ArgumentNullException	El parámetro de typeName y/o de identifier es null.
ArgumentOutOfRangeException	El parámetro de identifier es menor que cero o mayor o igual que el número de elementos en la matriz de identificador.

Comentarios

Este método debe utilizar las mismas reglas de comparación que el origen de datos para garantizar la unicidad correcta de objetos en el cliente.

Pasando el identificador de origen completo, algunas situaciones complejas pueden ser controlado. Por ejemplo, las versiones recientes de Microsoft SQL Server permiten que el servidor en conjunto está en comparación de identificador mientras una base de datos determinada en el servidor puede hacer distinción entre mayúsculas y minúsculas, o viceversa distingue entre mayúsculas y minúsculas. Esto significa que al comparar el esquema o nombre de una tabla (que aparece como la segunda y tercera partes en un identificador de tabla completo, la primera parte siendo la base de datos, la implementación de este método debe utilizar la primera parte de figurar out que la base de datos la tabla es en, etc., qué tipo de comparación que se va a utilizar.

La implementación base de este método utiliza el comparador predeterminado de objetos.NET (Comparer) cuando la parte del identificador de origen implementa IComparable; si no llama al método de Equals de reemplazo de la implementación de IComparable y devuelve 1 si este método devuelve false.

Este método trata nullreferencia null (Nothing en Visual Basic) y DBNull idéntico. Es decir, si un valor es DBNull y otro valor es nullreferencia null (Nothing en Visual Basic), tienen el mismo valor.

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

DataObjectItemComparer Clase

Compare (Sobrecarga)

Microsoft.VisualStudio.Data (Espacio de nombres)