Benutzerdefinierte mehrspaltige Feldklassen
Letzte Änderung: Samstag, 3. April 2010
Gilt für: SharePoint Foundation 2010
Zu SharePoint Foundation gehört die Klasse SPFieldMultiColumn, die ein Feld mit mehreren Werten emuliert. Tatsächlich enthält die Klasse einen einzelnen Zeichenfolgenwert, in dem die Werte verschiedener "Spalten" durch spezielle Trennzeichen voneinander getrennt sind. Die Klasse enthält Member, die es Ihnen ermöglichen, die Klasse so zu bearbeiten, als ob sie mehrere Spalten enthielte, beispielsweise beim Festlegen der Anzahl von "Spalten" und Festlegen oder Abrufen der einzelnen Werte von "Spalten".
Zugreifen auf Datenwerte für SPFieldMultiColumn-Objekte
Die SPFieldMultiColumn-Klasse enthält die SPFieldMultiColumnValue-Klasse, die die eigentlichen Werte der "Spalten" im SPFieldMultiColumn-Objekt darstellt. Die SPFieldMultiColumnValue-Klasse schließt einen Index ein, den Entwickler für den Zugriff auf den Wert einer bestimmten "Spalte" verwenden sollten, anstatt die Ergebnisse der ToString()-Methode direkt zu analysieren.
SPFieldMultiColumnValue-Klassenkonstruktoren
Die SPFieldMultiColumnValue-Klasse schließt drei Konstruktormethoden ein. Entwickler können anhand des folgenden Verhaltens entscheiden, welcher Konstruktor verwendet werden soll:
SPFieldMultiColumnValue() Erstellt ein neues SPFieldMultiColumnValue-Objekt ohne eine festgelegte Anzahl von "Spalten". Der Entwickler kann dann mithilfe der Add(String)-Methode eine beliebige Anzahl von erforderlichen Daten"spalten" an das Objekt anfügen.
SPFieldMultiColumnValue(Int32) Erstellt ein neues SPFieldMultiColumnValue-Objekt mit der angegebenen Anzahl von "Spalten". Entwickler können dann mithilfe der Item-Eigenschaft den Wert einer bestimmten "Spalte" abrufen und festlegen.
SPFieldMultiColumnValue(String) Erstellt ein neues SPFieldMultiColumnValue-Objekt mithilfe des übergebenen Zeichenfolgenarguments, um die Anzahl der "Spalten" und den jeweiligen Wert zu ermitteln. Das Zeichenfolgenargument muss mit den Trennzeichen ";#" beginnen und enden sowie jedes Feld trennen, das diese enthält.
Angenommen, Sie rufen beispielsweise diesen Konstruktor auf und übergeben dabei die folgende Zeichenfolge:
";#column one value;#column two value;#column three value;#"
Es wird vom Konstruktor ein neues SPFieldMultiColumnValue-Objekt mit drei Daten"spalten" erstellt. Die erste enthält "Wert Spalte eins", die zweite "Werte Spalte zwei" und die dritte "Wert Spalte drei".
Entwickler können dann mithilfe der Item-Eigenschaft den Wert einer bestimmten "Spalte" abrufen und festlegen.
Dieser Konstruktor erweist sich beim Lesen der Zeichenfolge aus einer Datenbank oder sonstigen Datenquelle als nützlich, in der die Spaltenwerte bereits mit den Trennzeichen gespeichert werden.
Schreiben von Werten der SPFieldMultiColumnValue-Klasse
Der letzte SPFieldMultiColumnValue-Konstruktor führt vom Konzept her genau die umgekehrte Funktion der ToString()-Methode durch. Die ToString()-Methode generiert eine Zeichenfolge einschließlich der Trennzeichen für die Trennung der "Spalten" aus dem SPFieldMultiColumnValue-Objekt. Diese Methode erweist sich beim Schreiben der Werte der "Spalten" in eine Datenbank oder sonstige Datenquelle als nützlich, in der die Werte der "Spalten" als Zeichenfolge bereits mit den Trennzeichen gespeichert werden.