Classes do campo personalizado Multicolumn

Windows SharePoint Services 3.0 contém uma classe, SPFieldMultiColumn, que emula um campo contendo múltiplo valores. Na realidade, a classe contém um valor da seqüência de caracteres única, na qual os valores de vários "colunas" são separadas por caracteres especiais delimitador. A classe contém membros que habilitar você manipular a classe como se ele continha múltiplo colunas; de exemplo, configuração de número de "colunas" e configuração ou recuperar o individual "coluna" valores.

Classes derivado do SPFieldMultiColumn classe T:Microsoft.SharePoint.SPFieldMultiColumn, Por padrão, herda esses membros. Além disso, derivado classes também podem aproveitar dos padrões processamento CAML (de colaboração de aplicativo de marcação de idioma) definido no SPFieldMultiColumn T:Microsoft.SharePoint.SPFieldMultiColumn definição campo de classe XML. Esses padrões processamento são para exibir e cabeçalho modos de exibição de dados de várias colunas.

Observação

Windows SharePoint Services 3.0, dados para campos SPFieldMultiColumn T:Microsoft.SharePoint.SPFieldMultiColumn são armazenados no de conteúdo banco de dados como uma tipo de dados SQL non-sortable.Por esse motivo, colunas com base na tipo de campo SPFieldMultiColumn T:Microsoft.SharePoint.SPFieldMultiColumn personalizado ou campo tipos derivado dele não é classificáveis.No entanto, você pode superar essa limitação usando Campos relacionados ao personalizado.

Para obter mais informações sobre definição campo XML e processar padrões, consulte Definição Tipo de campo personalizado.

Acessando dados valores para objetos SPFieldMultiColumn

O SPFieldMultiColumn T:Microsoft.SharePoint.SPFieldMultiColumn classe contém uma classe, valores no objeto T:Microsoft.SharePoint.SPFieldMultiColumn SPFieldMultiColumnValueSPFieldMultiColumn, que representa o real "coluna". O SPFieldMultiColumnValue T:Microsoft.SharePoint.SPFieldMultiColumnValue classe inclui um índice que os desenvolvedores devem usar para acessar o valor de um determinado "coluna", em vez de diretamente análise dos resultados de SPFieldMultiColumn.ToString método.

Construtores de classe SPFieldMultiColumnValue

O SPFieldMultiColumnValue T:Microsoft.SharePoint.SPFieldMultiColumnValue classe inclui três métodos construtor. Os desenvolvedores podem decidir qual construtor usar com base no seguinte comportamento:

• SPFieldMultiColumnValue cria um novo SPFieldMultiColumnValue objeto, sem um número conjunto de "colunas". O desenvolvedor poderá, então, usar o SPFieldMultiColumnValue.Add método para anexar qualquer número de "colunas" dos dados necessários para o objeto.

• SPFieldMultiColumnValue cria um novo objeto SPFieldMultiColumnValue com o número especificado de "colunas". Os desenvolvedores podem, em seguida, usar o Item P:Microsoft.SharePoint.SPFieldMultiColumnValue.Item(System.Int32) propriedade get e definir o valor de um determinado "coluna".

• SPFieldMultiColumnValue cria um objeto SPFieldMultiColumnValue novo, usando o argumento seqüência de caracteres Passed-in para determinar o número de "colunas" e o valor em cada. O argumento seqüência de caracteres deve começam e terminam com os caracteres delimitador "; # " e ele deve separar cada campo com eles as well.

  De exemplo, suponha que você chamar esse construtor, passando o seguinte seqüência de caracteres:

  ";#column one value;#column two value;#column three value;#"
  

  O construtor cria um novo objeto SPFieldMultiColumnValue com três "colunas" de dados. O primeiro contém "coluna valor um"; a segunda, "valor coluna duas"; e a terceira, "valor coluna três".

  Os desenvolvedores podem, em seguida, usar o Item P:Microsoft.SharePoint.SPFieldMultiColumnValue.Item(System.Int32) propriedade get e definir o valor de um determinado "coluna".

  Esse construtor é útil ao ler a seqüência de caracteres de um banco de dados ou outras fonte de dados onde os valores coluna são armazenados com os caracteres de delimitação que já esteja no local.

Gravando valores de classe de SPFieldMultiColumnValue

Conceitualmente, o construtor final SPFieldMultiColumnValue T:Microsoft.SharePoint.SPFieldMultiColumnValue executa o oposto função das M:Microsoft.SharePoint.SPFieldMultiColumnValue.ToStringmétodo. O M:Microsoft.SharePoint.SPFieldMultiColumnValue.ToStringmétodo gera um seqüência de caracteres, completo com que delimita caracteres de separação "coluna", a partir de objeto SPFieldMultiColumnValue T:Microsoft.SharePoint.SPFieldMultiColumnValue. Este método é útil ao gravar os valores "coluna" um banco de dados ou outras fonte de dados onde os valores "coluna" são armazenados como um seqüência de caracteres, com os caracteres de delimitação que já esteja no local.

Consulte também

Conceitos

Tipos de campo personalizado
Classes do campo personalizado
A validação de dados do campo personalizado