ViewCollection.Add(Control) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el control View especificado a la colección.
public:
override void Add(System::Web::UI::Control ^ v);
public override void Add (System.Web.UI.Control v);
override this.Add : System.Web.UI.Control -> unit
Public Overrides Sub Add (v As Control)
Parámetros
Excepciones
El parámetro v
no especifica un control View.
Ejemplos
En el ejemplo de código siguiente se muestra cómo agregar View controles a un MultiView control mediante programación. Una vez creado cada View control, la MultiView.Views.Add()
sintaxis se usa para agregar el View control a la ViewCollection colección del MultiView control.
<%@ Page Language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ViewCollection Class Example</title>
<script runat="server">
Sub Index_Changed(ByVal Sender As Object, ByVal e As EventArgs)
' A MultiView was added to the page declaratively.
' Now add the View control programmatically.
If SelectViewListBox.SelectedIndex >= 0 Then
' The user selected a view.
' Determine which view the user selected.
Dim viewName As String = SelectViewListBox.SelectedItem.Text
Dim myView as New View
' Use a helper function to create the view.
myView = CreateView(viewName, "This is " + viewName)
' Add myView to the ViewCollection of the MultiView1 control.
MultiView1.Views.Add(myView)
' Set myView as the active view.
MultiView1.SetActiveView(myView)
' The Panel control was initially set to not visible.
' Set it to visible to add styles to the myView.
Panel1.Visible=True
Else
Throw New Exception("You did not select a valid view.")
End If
End Sub
' A function to programmatically create a View control.
Private Function CreateView(ByVal viewId As String, ByVal viewDescription As String) As View
' Create a View control
Dim myView As New View
myView.ID = viewId
' Create a Label control.
Dim Label1 As New Label
' Set the text property for the label.
Label1.Text = viewDescription
' Add the label to the controls collection of the view.
myView.Controls.Add(Label1)
Return myView
End Function
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>ViewCollection Class Example</h3>
<h4>Select a View to create and display in a MultiView control:</h4>
<asp:ListBox ID="SelectViewListBox"
AutoPostBack="True"
Rows="1"
SelectionMode="Single"
OnSelectedIndexChanged="Index_Changed"
runat="Server">
<asp:ListItem Value="0">View1</asp:ListItem>
<asp:ListItem Value="1">View2</asp:ListItem>
</asp:ListBox><br /><br />
<hr /><br />
<asp:Panel ID="Panel1"
Height="75px"
Width="100px"
Backcolor="Aqua"
BorderStyle="Double"
Visible = "False"
runat="Server">
<asp:MultiView ID="MultiView1"
runat="Server">
</asp:MultiView>
</asp:Panel>
</form>
</body>
</html>
Comentarios
El Add método agrega el nuevo control al final de una matriz de índices ordinales. El control solo puede ser una instancia de un View control .
Para agregar un control a la colección en una ubicación de índice específica, use el AddAt método .