Classes de champ multicolonne personnalisées
Dernière modification : samedi 3 avril 2010
S’applique à : SharePoint Foundation 2010
SharePoint Foundation contient une classe, SPFieldMultiColumn, qui émule un champ contenant plusieurs valeurs. En réalité, cette classe contient une seule valeur de chaîne, dans laquelle les valeurs des différentes « colonnes » sont séparées par des caractères de délimitation spéciaux. La classe contient des membres qui vous permettent de la manipuler comme si elle contenait plusieurs colonnes ; par exemple vous pouvez définir le nombre de « colonnes » et définir ou récupérer les valeurs d’une « colonne » individuelle.
Accès aux valeurs de données des objets SPFieldMultiColumn
La classe SPFieldMultiColumn contient une classe, SPFieldMultiColumnValue, qui représente les véritables valeurs de « colonne » de l’objet SPFieldMultiColumn. La classe SPFieldMultiColumnValue comporte un index que les développeurs doivent utiliser pour accéder à la valeur d’une « colonne » spécifique, plutôt que d’analyser directement les résultats de la méthode ToString().
Constructeurs de la classe SPFieldMultiColumnValue
La classe SPFieldMultiColumnValue inclut trois méthodes de constructeur. Les développeurs peuvent décider du constructeur à utiliser selon le comportement suivant :
SPFieldMultiColumnValue() crée un nouvel objet SPFieldMultiColumnValue, sans un nombre défini de « colonnes ». Le développeur peut alors utiliser la méthode Add(String) pour ajouter le nombre de « colonnes » de données nécessaires sur l’objet.
SPFieldMultiColumnValue(Int32) Crée un nouvel objet SPFieldMultiColumnValue avec le nombre spécifié de « colonnes ». Les développeurs peuvent ensuite utiliser la propriété Item pour obtenir et définir la valeur d’une « colonne » spécifique.
SPFieldMultiColumnValue(String) Crée un nouvel objet SPFieldMultiColumnValue, en utilisant l’argument de chaîne transmis pour déterminer le nombre de « colonnes » et la valeur de chacune. L’argument de chaîne doit commencer et se terminer par les caractères délimiteurs « ;# » et il doit aussi les utiliser pour séparer chaque champ.
Par exemple, supposons que vous appeliez ce constructeur en passant la chaîne suivante :
";#column one value;#column two value;#column three value;#"
Le constructeur crée un nouvel objet SPFieldMultiColumnValue avec trois « colonnes » de données. La première contient « valeur de colonne une », la deuxième, « valeur de colonne deux » et la troisième « valeur de colonne trois ».
Les développeurs peuvent ensuite utiliser la propriété Item pour obtenir et définir la valeur d’une « colonne » spécifique.
Ce constructeur est utile lors de la lecture de la chaîne à partir d’une base de données ou d’une autre source de données où les valeurs des colonnes sont stockées avec les caractères de délimitation déjà en place.
Écriture des valeurs à partir de la classe SPFieldMultiColumnValue
D’un point de vue conceptuel, le constructeur SPFieldMultiColumnValue final exécute la fonction inverse de la méthode ToString(). La méthode ToString() produit une chaîne, complète avec les caractères délimitant les « colonnes », à partir de l’objet SPFieldMultiColumnValue. Cette méthode est utile lors de l’écriture des valeurs de « colonne » dans une base de données ou une autre source de données où les valeurs de « colonne » sont stockées sous la forme d’une chaîne, avec les caractères de délimitation déjà en place.