Clases de campos de varias columnas personalizados
Última modificación: sábado, 03 de abril de 2010
Hace referencia a: SharePoint Foundation 2010
SharePoint Foundation contiene una clase, SPFieldMultiColumn, que emula un campo que contiene varios valores. En realidad, la clase contiene un valor de cadena único, en el que los valores de las diversas "columnas" están separados por caracteres delimitadores especiales. La clase contiene miembros que le permitirán manipular la clase como si contuviera varias columnas; por ejemplo, establecer el número de "columnas" y configurar o recuperar los distintos valores de "columna".
Acceso a valores de datos para objetos SPFieldMultiColumn
La clase SPFieldMultiColumn contiene una clase, SPFieldMultiColumnValue, que representa los valores reales de "columna" en el objeto SPFieldMultiColumn. La clase SPFieldMultiColumnValue incluye un índice que los desarrolladores deben usar para obtener acceso al valor de una "columna" específica en lugar de analizar directamente los resultados del método ToString().
Constructores de clase SPFieldMultiColumnValue
La clase SPFieldMultiColumnValue incluye tres métodos de constructor. Los desarrolladores pueden decidir qué constructor usar en función del siguiente comportamiento:
SPFieldMultiColumnValue() Crea un nuevo objeto SPFieldMultiColumnValue sin un número establecido de "columnas". A continuación, el desarrollador puede usar el método Add(String) para anexar cualquier número de "columnas" de datos necesarios al objeto.
SPFieldMultiColumnValue(Int32) Crea un nuevo objeto SPFieldMultiColumnValue con el número especificado de "columnas". A continuación los desarrolladores pueden usar la propiedad Item para obtener y establecer el valor de una "columna" determinada.
SPFieldMultiColumnValue(String) Crea un objeto SPFieldMultiColumnValue nuevo, utilizando el argumento de cadena transferido para determinar el número de "columnas" y el valor de cada una de ellas. El argumento de cadena debe comenzar y terminar con los caracteres delimitadores ";# " y debe también separar cada uno de los campos con ellos.
Por ejemplo, suponga que llama a este constructor y pasa la cadena siguiente:
";#column one value;#column two value;#column three value;#"
El constructor crea un nuevo objeto SPFieldMultiColumnValue con tres "columnas" de datos. La primera contiene el "valor de la columna uno", la segunda el "valor de la columna dos" y la tercera el "valor de la columna tres".
Los desarrolladores pueden entonces usar la propiedad Item para obtener y establecer el valor de una "columna" determinada.
Este constructor es útil cuando se lee la cadena de una base de datos u otro origen de datos donde se almacenan los valores de columna con los caracteres delimitadores ya situados en su lugar.
Escritura de valores de la clase SPFieldMultiColumnValue
Conceptualmente, el constructor SPFieldMultiColumnValue final realiza la función opuesta del método ToString(). El método ToString() genera una cadena, completa con caracteres delimitadores de separación de "columna", a partir del objeto SPFieldMultiColumnValue. Este método es útil al escribir los valores de "columna" en una base de datos u otro origen de datos donde los valores de la "columna" se almacenan como una cadena, con los caracteres delimitadores situados ya en su lugar.
Vea también
Conceptos
Tipos de campos personalizados