DataObjectItemComparer.Compare メソッド (String, array<Object[], Int32, Object)
別の指定したオブジェクトの識別子の一部をの 1 種類のオブジェクトの識別子の一部を比較します。
名前空間: 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
型 : Stringオブジェクト型の名前。
identifier
型 : array<Object[]typeName のパラメーターで指定される型のオブジェクトの識別子。
identifierPart
型 : Int32比較するために、識別子のどの部分を示す識別子の配列へのゼロ ベースのインデックス。
value
型 : Object識別子の一部として比較する値。
戻り値
型 : Int32
識別子の一部である値よりも小さい場合も少ないゼロを返します。識別子の一部が指定の値と等しい場合はゼロを返します。識別子の一部である値よりも非常により、ゼロを返します。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | typeName や identifier のパラメーターが null です。 |
| ArgumentOutOfRangeException | identifier のパラメーターは、以上で識別子の配列の要素数にサブプロパティの数未満です。 |
解説
このメソッドは、データ ソースとクライアント側のオブジェクトの正しい一意性を保証する同じ比較規則を使用する必要があります。
完全なソース・識別子を渡すことによって、特定の複雑な状況は処理できます。 たとえば、Microsoft SQL Server の最新バージョンをサーバーの特定のデータベースが大文字と小文字である、または逆に全体として使用すると、サーバー間で大文字と小文字を区別する識別子の比較にできます。 これは、使用するような比較をテーブル (完全なテーブル識別子の 2 番目と 3 番目の表示である、最初の一部として) データベースのスキーマまたは名前比較するとき、このメソッドの実装を計算するためにデータベースがテーブルについて、および軽減する必要がある最初の識別子の一部を使用することを意味します。
このメソッドの基本実装では、ソース識別子の一部が IComparableを実行するときに、既定の .NET オブジェクトの比較子を使用します (Comparer) ; それ以外の場合は、このメソッドが false を返した場合 IComparable の実装のオーバーライドの Equals のメソッドを呼び出し、1 を返します。
このメソッドは nullnull 参照 (Visual Basic では Nothing) と DBNull を同じように処理します。 つまり、1 の値が DBNull で、他の値が nullnull 参照 (Visual Basic では Nothing)場合、同じ値である場合。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。