DataObjectMemberComparer.Compare メソッド (String, array<Object , Int32, Object)

別の指定したオブジェクトの識別子の一部をの 1 種類のオブジェクトの識別子の一部を比較します。

名前空間:  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

パラメーター

  • identifier
    型 : array<System.Object[]
    データ ソース オブジェクトの識別子の一部の配列。
  • identifierPart
    型 : System.Int32
    比較するために、識別子のどの部分を示す識別子の配列から始まるインデックス。
  • value
    型 : System.Object
    識別子の一部として比較する値。

戻り値

型 : System.Int32
識別子の一部である値よりも小さい場合、値より小さいゼロ; 識別子の一部が指定の値と等しい場合はゼロ; 識別子の一部である値よりも大きい値はゼロ。

実装

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

例外

例外 条件
ArgumentNullException

typeName や identifier のパラメーターは nullnull 参照 (Visual Basic では Nothing)です。

ArgumentOutOfRangeException

identifier のパラメーターは、以上で識別子の配列の要素数にサブプロパティの数未満です。

解説

このメソッドは、データ ソースとクライアント側のオブジェクトの正しい一意性を保証する同じ比較規則を使用する必要があります。

完全なソース・識別子を渡す場合は、特定の複雑な状況を処理できます。たとえば、Microsoft SQL Server の最新バージョンをサーバーの特定のデータベースが大文字と小文字である、または逆に全体として使用すると、サーバー間で大文字と小文字を区別する識別子の比較にできます。これはスキーマを比較するときに、最初の識別子の一部を使用するデータベース テーブルであり、したがってかを判断するためにテーブル (使用するような比較を 2 番目の完全なテーブル識別子の 3 番目の部分は、データベースにある最初の部分として表示) の名前が、このメソッドの実装ことを意味します。

このメソッドの基本実装では、ソース識別子の一部が IComparableを実行すると、既定の .NET Framework のオブジェクトの比較子を使用します (Comparer) ; それ以外の場合は、このメソッドがを返した場合 falseIComparable の実装のオーバーライドの Equals のメソッドを呼び出し、1 を返します。

このメソッドは、null を DBNull と同じように処理します。つまり、1 の値が DBNull で、他の値が null の場合、同じ値である場合。

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

DataObjectMemberComparer クラス

Compare オーバーロード

Microsoft.VisualStudio.Data.Framework 名前空間