SfcKey クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SfcKey クラスは、すべての SfcInstance 派生オブジェクトに必要なすべての入れ子になった Key クラスの基本クラスです。 キーは等しいかどうかを知る必要があるため、等価性とハッシュは実装されますが、比較は実装されません。
キーは、構築後は変更不可であるため、Key オブジェクトの有効期間中に変更できるデータを Key に含めないようにする必要があります。 Key が表す ID の真の一部ではないキーの一部としてフィールドを使用しないでください。 これは、Key の内部プロパティに対して set() を禁止することによって適用できます。
順序または照合順序のニーズは、次の実装によって対処されます。
- SfcKey 派生クラスの IComparable
- SfcCollection 派生コレクション クラスの IComparer または IComparer<T>
public abstract class SfcKey : IEquatable<Microsoft.SqlServer.Management.Sdk.Sfc.SfcKey>type SfcKey = class
interface IEquatable<SfcKey>Public MustInherit Class SfcKey
Implements IEquatable(Of SfcKey)- 継承
-
SfcKey
- 派生
- 実装
コンストラクター
| 名前 | 説明 |
|---|---|
| SfcKey() |
SfcKey クラスは、すべての SfcInstance 派生オブジェクトに必要なすべての入れ子になった Key クラスの基本クラスです。 キーは等しいかどうかを知る必要があるため、等価性とハッシュは実装されますが、比較は実装されません。 キーは、構築後は変更不可であるため、Key オブジェクトの有効期間中に変更できるデータを Key に含めないようにする必要があります。 Key が表す ID の真の一部ではないキーの一部としてフィールドを使用しないでください。 これは、Key の内部プロパティに対して set() を禁止することによって適用できます。 順序または照合順序のニーズは、次の実装によって対処されます。
|
プロパティ
| 名前 | 説明 |
|---|---|
| InstanceType |
このキー クラスに関連付けられているインスタンス クラスの型。 既定の impl は、入れ子になったキー クラスが、その手法を使用して既存のモデルと互換性を持つ場合に行う方法です。 これは、インスタンス型の入れ子になったクラスではない任意のキー クラスでオーバーライドする必要があります。 |
メソッド
| 名前 | 説明 |
|---|---|
| Equals(Object) |
各キーは、そのデータ メンバーの適切な値比較を行う必要があります。 オブジェクトのように参照等価チェックのみに依存 しないでください 。 |
| Equals(SfcKey) |
SfcKey クラスは、すべての SfcInstance 派生オブジェクトに必要なすべての入れ子になった Key クラスの基本クラスです。 キーは等しいかどうかを知る必要があるため、等価性とハッシュは実装されますが、比較は実装されません。 キーは、構築後は変更不可であるため、Key オブジェクトの有効期間中に変更できるデータを Key に含めないようにする必要があります。 Key が表す ID の真の一部ではないキーの一部としてフィールドを使用しないでください。 これは、Key の内部プロパティに対して set() を禁止することによって適用できます。 順序または照合順序のニーズは、次の実装によって対処されます。
|
| GetHashCode() |
各キーは、データ メンバーに適切なハッシュ コードを提供する必要があります。 内部的には、文字列は既定のハッシュ コードを使用でき、数値は直接使用することも、ビットシフトして int に切り捨てることもできます。通常、内部データの複数のハッシュ コードを XOR にまとめて、適切な結果を生成できます。 |
| GetUrnFragment() |
各キーは、有効な XPath 指向 ID 文字列フラグメントを生成する方法を実装する必要があります。このフラグメントを使用して、キーの SfcKeyChain[] から完全で有効な Urn を作成します。 |
| ToString() |
各キー |