Método DataObjectItemComparer.Compare (String, array<Object , Int32, Object)
Compara uma parte do identificador de objeto com outra parte específica do identificador de objeto.
Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)
Sintaxe
'Declaração
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: System.String
o nome de um tipo de objeto.
- identifier
Tipo: array<System.Object[]
O identificador de um objeto do tipo especificado pelo parâmetro de typeName .
- identifierPart
Tipo: System.Int32
O índice com base zero no array de identificadores que indica que parte do identificador para comparar.
- value
Tipo: System.Object
Um valor para comparar a parte do identificador em.
Valor de retorno
Tipo: System.Int32
O retorna menor que zero nas caixas onde a parte do identificador é menor que o valor especificado.Retorna zero se a parte do identificador é igual ao valor especificado.Retorna maior que zero se a parte do identificador é maior que o valor especificado.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentNullException | O parâmetro de typeName e/ou de identifier é zero. |
| ArgumentOutOfRangeException | O parâmetro de identifier é menor que zero ou maior ou igual ao número de elementos no array de identificadores. |
Comentários
Esse método deve usar as mesmas regras de comparação que a fonte de dados para garantir a unicidade correta de objetos no lado do cliente.
Passando o manipulador de fonte completo, determinadas situações complexas podem ser tratadas.Por exemplo, as versões recentes do Microsoft SQL Server para permitir que o servidor está em conjunto com diferenciação de maiúsculas e minúsculas em comparação de identificadores quando um banco de dados específico no servidor possa diferenciar maiúsculas de minúsculas, ou vice-versa.Isso significa que para comparar o esquema ou nome de uma tabela (que aparece como a segunda e terceira partes em um identificador de tabela completa, a primeira parte sendo o banco de dados), a implementação do método deve usar a primeira parte do identificador para figurar para fora do banco de dados é na tabela, e assim, o tipo de comparação a ser usada.
A implementação base de este método usa o comparer do objeto de opção .NET (Comparer) quando a parte do identificador de fonte implementa IComparable; se não chama o método de Equals de substituição de implementação de IComparable e retorna 1 se esse método retornar falso.
Este método trata nulluma referência nula (Nothing no Visual Basic) e DBNull idêntica.Isto é, se um valor é DBNull e o outro valor é nulluma referência nula (Nothing no Visual Basic), são considerados o mesmo valor.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.