Caixa de diálogo Vincular aos dados: componente de lista

Consulte também

Esta caixa de diálogo permite que você associe um provedor de dados ou objeto à propriedade items do componente, que exibe os itens de lista no componente. Você pode criar esta associação, se quiser alterar os itens na lista do componente no tempo de execução.

A caixa de diálogo abre quando você clica com o botão direito do mouse em um componente Caixa de listagem básica, Grupo de caixas de verificação, Grupo de botões de opção ou Lista suspensa que tenha adicionado a uma página JSF Visual Web e escolhe Vincular aos dados.

O campo superior da caixa de diálogo mostra a configuração atual da propriedade items do componente. Por padrão, esta propriedade é vinculada à propriedade options do objeto padrão que preenche a lista. Por exemplo, para uma lista suspensa chamada dropDown1, este objeto seria dropDown1DefaultOptions.

Para definir uma vinculação, primeiro escolha a aba que faz o tipo de vinculação desejada, Vincular ao provedor de dados ou Vincular ao objeto.

Vincular ao provedor de dados

Esta aba permite que você vincule a propriedade component a uma coluna de banco de dados que você adicionou na página antes de acessar esta caixa de diálogo.

Se o provedor de dados não for o que você deseja usar, selecione outro provedor de dados na lista suspensa Escolher um provedor de dados. Se você não vir o provedor de dados listado, você deve adicionar uma tabela de banco de dados à página, como apropriado para a aplicação.

Quando você tiver selecionado o provedor de dados desejado, as listas Campo de valor e Campo de exibição são preenchidas com os itens do provedor de dados. Dependendo do objeto representado pelo provedor de dados, os itens nessas listas podem representar colunas de banco de dados, métodos de serviço Web ou métodos de enterprise bean. As duas colunas representam aspectos diferentes dos itens da lista exibidos pelo componente na página.

Selecione os itens que preencherão a lista do componente.

Quando você seleciona um item, o campo de entrada superior da caixa de diálogo é preenchido com uma expressão JavaServer Faces que faz referência ao item selecionado.

Quando você estiver satisfeito com a sua seleção, clique em OK para aplicar a vinculação à propriedade items do componente.

Vincular a um objeto

Esta aba permite que você vincule a propriedade component a uma propriedade JavaBeans. Se preferir, você pode criar seus próprios objetos JavaBeans para controlar os itens da lista. Vincule a uma propriedade selecionando-a e clicando em OK.

Por padrão, a propriedade items de um componente Lista é vinculada à propriedade options de um objeto que o IDE cria para preencher a lista. Você geralmente trabalha com este objeto, clicando com o botão direito do mouse no componente na página e escolhendo Configurar opções padrão. Você também pode criar seu próprio objeto para preencher a lista.

Por exemplo, o objeto JavaBeans criado para uma lista suspensa do JavaServer Faces 1.2 chamada dropDown1 denomina-se dropDown1DefaultOptions. A propriedade Options deste objeto é uma matriz de objetos com.sun.webui.jsf.model.Option, cada um possui dois campos, label do tipo String, o valor exibido na lista, e value do tipo Objeto, o valor do item da lista.

Consulte também
Componente Grupo de caixas de seleção
Componente Lista suspensa
Componente Caixa de listagem
Componente Grupo de botões de opção
Sobre os componentes de vinculação a dados
Sobre componentes e dados

Notificações legais