Cómo: Agregar elementos a controles List de servidor Web (Visual Studio)

  • Artículo

Actualización: noviembre 2007

La información de este tema se aplica a los siguientes controles de servidor Web:

Puede agregar elementos a un control de lista de servidor Web de estas tres formas:

Cuando agregue un elemento de lista, puede especificar un máximo de tres propiedades del elemento. En la tabla siguiente se describen estas propiedades.

Propiedad

Descripción

Text

Especifica el texto que se muestra en la lista.

Value

Especifica un valor que se asocia a un elemento pero que no se muestra. Por ejemplo, puede establecer la propiedad Text en el nombre de un elemento químico y la propiedad Value en su símbolo.

Selected

Indica si se selecciona el elemento. En un control CheckBoxList y en un control ListBox de selección múltiple, se pueden seleccionar varios elementos. En el control DropDownList, el control RadioButtonList y el control ListBox de selección simple, sólo se puede seleccionar un único elemento a la vez. Si establece en estos controles más de un elemento seleccionado, el explorador determinará qué elemento se representa como seleccionado. En un control BulletedList, este valor de configuración no tiene ningún efecto.

Para agregar elementos estáticos en tiempo de diseño.

  1. En la vista Diseño, seleccione el control de lista al que desee agregar los elementos.

    En la ventana Propiedades, haga clic en el botón de puntos suspensivos () situado en el cuadro Items.

    Aparece el cuadro de diálogo Editor de la colección ListItem.

  2. Haga clic en Agregar para agregar un nuevo elemento.

  3. Seleccione el nuevo elemento y, a continuación, escriba los valores de las propiedades Text, Value y Selected en la cuadrícula de propiedades.

  4. Repita los pasos 2 y 3 para cada elemento que desee agregar y, a continuación, haga clic en Aceptar.

Para agregar elementos mediante programación

  1. Cree un nuevo objeto de tipo ListItem y establezca sus propiedades Text y Value. Normalmente, el nuevo objeto ListItem se crea llamando al método Add.

  2. Llame al método Add de la colección Items del control y pásele el nuevo objeto.

    En el ejemplo siguiente se muestra cómo se agregan objetos ListItem a un control ListBox; este procedimiento es idéntico para todos los controles de lista de servidor Web.

    Protected Sub Button1_Click(ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button1.Click
    ListBox1.Items.Add(New ListItem("Carbon", "C"))
    ListBox1.Items.Add(New ListItem("Oxygen", "O"))
End Sub

    Protected void Button1_Click (object sender, System.EventArgs e)
{
    ListBox1.Items.Add(new ListItem("Carbon", "C"));
    ListBox1.Items.Add(new ListItem("Oxygen", "O"));
}

Vea también

Tareas

Cómo: Rellenar controles List de servidor Web desde un origen de datos (Visual Studio)