Sprache

SfcKey Klasse

Definition

Die SfcKey-Klasse ist die Basisklasse für alle geschachtelten Key-Klassen, die jedes von SfcInstance abgeleitete Objekt aufweisen muss. Es implementiert Gleichheit und Hashing, aber keinen Vergleich, da Schlüssel nur wissen müssen, ob sie gleich sind oder nicht.

Schlüssel sollen nach der Konstruktion unveränderlich sein, daher sollte ein Schlüssel keine Daten enthalten, die sich während der Lebensdauer des Key-Objekts ändern können. Verwenden Sie keine Felder als Teil eines Schlüssels, der nicht wirklich Teil der Identität ist, die der Schlüssel darstellt. Wir können dies erzwingen, indem wir set() für die internen Eigenschaften für den Schlüssel aufheben.

Alle Sortier- oder Sortierungsanforderungen werden durch die Implementierung von:

  1. IComparable für die von SfcKey abgeleitete Klasse
  2. IComparer oder IComparer<T> für die von SfcCollection abgeleitete Sammlungsklasse
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)
Vererbung
SfcKey
Abgeleitet
Implementiert

Konstruktoren

Name Beschreibung
SfcKey()

Die SfcKey-Klasse ist die Basisklasse für alle geschachtelten Key-Klassen, die jedes von SfcInstance abgeleitete Objekt aufweisen muss. Es implementiert Gleichheit und Hashing, aber keinen Vergleich, da Schlüssel nur wissen müssen, ob sie gleich sind oder nicht.

Schlüssel sollen nach der Konstruktion unveränderlich sein, daher sollte ein Schlüssel keine Daten enthalten, die sich während der Lebensdauer des Key-Objekts ändern können. Verwenden Sie keine Felder als Teil eines Schlüssels, der nicht wirklich Teil der Identität ist, die der Schlüssel darstellt. Wir können dies erzwingen, indem wir set() für die internen Eigenschaften für den Schlüssel aufheben.

Alle Sortier- oder Sortierungsanforderungen werden durch die Implementierung von:

  1. IComparable für die von SfcKey abgeleitete Klasse
  2. IComparer oder IComparer<T> für die von SfcCollection abgeleitete Sammlungsklasse

Eigenschaften

Name Beschreibung
InstanceType

Der Typ der Instanzklasse, die dieser Schlüsselklasse zugeordnet ist. Standardimpl ist die Art und Weise, wie eine geschachtelte Schlüsselklasse dies für die Kompatibilität mit vorhandenen Modellen mit dieser Technik tun würde. Dies sollte in jeder Schlüsselklasse außer Kraft gesetzt werden, bei der es sich nicht um eine geschachtelte Klasse des Instanztyps handelt.

Methoden

Name Beschreibung
Equals(Object)

Jeder Schlüssel muss einen ordnungsgemäßen Wertvergleich seiner Datenmmber ausführen. Verlassen Sie sich nicht ausschließlich auf die Referenzgleichheitsprüfung wie das Objekt.

Equals(SfcKey)

Die SfcKey-Klasse ist die Basisklasse für alle geschachtelten Key-Klassen, die jedes von SfcInstance abgeleitete Objekt aufweisen muss. Es implementiert Gleichheit und Hashing, aber keinen Vergleich, da Schlüssel nur wissen müssen, ob sie gleich sind oder nicht.

Schlüssel sollen nach der Konstruktion unveränderlich sein, daher sollte ein Schlüssel keine Daten enthalten, die sich während der Lebensdauer des Key-Objekts ändern können. Verwenden Sie keine Felder als Teil eines Schlüssels, der nicht wirklich Teil der Identität ist, die der Schlüssel darstellt. Wir können dies erzwingen, indem wir set() für die internen Eigenschaften für den Schlüssel aufheben.

Alle Sortier- oder Sortierungsanforderungen werden durch die Implementierung von:

  1. IComparable für die von SfcKey abgeleitete Klasse
  2. IComparer oder IComparer<T> für die von SfcCollection abgeleitete Sammlungsklasse
GetHashCode()

Jeder Schlüssel muss einen angemessenen Hashcode für seine Datenmember bereitstellen. Intern können Zeichenfolgen ihre Standardhashcodes verwenden, und numerische Werte können direkt oder bitverschiebet verwendet und int abgeschnitten werden. Mehrere Hashcodes für interne Daten können in der Regel XOR'd zusammen sein, um ein anständiges Ergebnis zu erzielen.

GetUrnFragment()

Jeder Schlüssel muss implementieren, wie ein gültiges XPath-orientiertes Identitätszeichenfolgenfragment erstellt wird, das zum Erstellen vollständiger und gültiger Urn aus einer SfcKeyChain von Key[] verwendet wird.

ToString()

Jede Taste

Gilt für: