ViewCollection Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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í.

Representa un contenedor de colecciones que permite que un control MultiView mantenga una lista de sus controles secundarios.

public ref class ViewCollection : System::Web::UI::ControlCollection

public class ViewCollection : System.Web.UI.ControlCollection

type ViewCollection = class
    inherit ControlCollection

Public Class ViewCollection
Inherits ControlCollection

Herencia: Object

ControlCollection
ViewCollection

Ejemplos

En el ejemplo de código siguiente se muestra cómo agregar View controles a un MultiView control mediante programación. Después de crear cada View control, el AddAt método se usa para agregar el View control a la ViewCollection colección del MultiView control en el índice especificado. El Item[] indexador se usa para tener acceso a las ID propiedades de los View controles almacenados en la ViewCollection colección y mostrarlas al usuario.

<%@ 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 example</title>
<script runat="server">
      
        Sub Button1_Click(ByVal Sender As Object, ByVal e As EventArgs)
            ' Create a MultiView control.
            Dim MultiView1 As New MultiView

            ' Create a ViewCollection for the View 
            ' controls contained in MultiView1.
            Dim myViewCollection As New ViewCollection(MultiView1)

            ' Create a View control. 
            Dim View1 As New View
            ' Use a helper function to create the view.
            View1 = CreateView("View1")
            ' Add View1 to myViewCollection at index 0.
            myViewCollection.AddAt(0, View1)

            ' Create a second View control and 
            ' add it to myViewCollection at index 1.
            Dim View2 As New View
            View2 = CreateView("View2")
            myViewCollection.AddAt(1, View2)

            ' Create a third View control and 
            ' add it to myViewCollection at index 0.
            ' Inserting View3 at index 0 
            ' causes View1 to move to index 1  
            ' and View2 to move to index 2.
            Dim View3 As New View
            View3 = CreateView("View3")
            myViewCollection.AddAt(0, View3)

            ' Show the contents of myViewCollection on the page.
            DisplayViewCollectionContents(myViewCollection)
            
        End Sub

        ' A function to programmatically create a View control.
        Private Function CreateView(ByVal viewId As String) As View
            ' Create a View control
            Dim myView As New View
            myView.ID = viewId

            ' Create a Panel control.
            Dim Panel1 As New Panel

            ' Set the style properties for Panel1.
            Panel1.Height = New Unit(150)
            Panel1.Width = New Unit(150)
            Panel1.BackColor = System.Drawing.Color.Azure
            Panel1.BorderStyle = BorderStyle.Double

            ' Add Panel1 to the Controls collection
            ' of the View control.
            myView.Controls.Add(Panel1)

            ' Create a Label control.
            Dim Label1 As New Label

            ' Set the properties for Label1.
            Label1.Text = "This is " + CStr(myView.ID)

            ' Add Label1 to the Controls collection
            ' of the Panel1 control.
            Panel1.Controls.Add(Label1)

            Return myView
        End Function

        ' A sub-routine to display the contents of myViewCollection.
        Sub DisplayViewCollectionContents(ByVal collection As ViewCollection)
            ' Use the Item property to access the ID of the View
            ' control at the specified index in the collection.
            Label1.Text = "The view at index 0 is " + collection.Item(0).ID
            Label2.Text = "The view at index 1 is " + collection.Item(1).ID
            Label3.Text = "The view at index 2 is " + collection.Item(2).ID
        End Sub

</script>
 
</head>
<body>

    <form id="Form1" runat="server">

        <h3>ViewCollection example</h3> 

        <asp:Button id="Button2" 
            Text="Show ViewCollection contents" 
            OnClick="Button1_Click" 
            runat="Server"/>
        <br /><br />  
        
        <hr />
  
        <asp:Label ID="Label1"
            runat="Server">
        </asp:Label><br /><br /> 

        <asp:Label ID="Label2"
            runat="Server">
        </asp:Label><br /><br />

        <asp:Label ID="Label3"
            runat="Server">
        </asp:Label><br /><br /> 
       
    </form>
   
</body>
</html>

Comentarios

La ViewCollection clase representa un contenedor de recopilación que permite a un MultiView control mantener una lista de sus controles secundarios. Un MultiView control solo View puede contener controles como controles secundarios.

Use el Add método para agregar un nuevo View control a la ViewCollection colección al final de una matriz de índices ordinales. Use el AddAt método para agregar un nuevo control en una ubicación de índice específica. Use el Item[] indizador para obtener un View control de la ViewCollection colección en un índice especificado, mediante la notación de matriz simple.

Constructores

ViewCollection(Control)

Inicializa una nueva instancia de la clase ViewCollection.

Propiedades

Count	Obtiene el número de controles de servidor que hay en el objeto ControlCollection para el control de servidor ASP.NET especificado. (Heredado de ControlCollection)
IsReadOnly	Obtiene un valor que indica si el objeto ControlCollection es de solo lectura. (Heredado de ControlCollection)
IsSynchronized	Obtiene un valor que indica si el objeto ControlCollection está sincronizado. (Heredado de ControlCollection)
Item[Int32]	Obtiene una referencia al control View en la ubicación de índice especificada en la colección ViewCollection.
Owner	Obtiene el control de servidor ASP.NET al que pertenece el objeto ControlCollection. (Heredado de ControlCollection)
SyncRoot	Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles. (Heredado de ControlCollection)

Métodos

Add(Control)	Agrega el control View especificado a la colección.
AddAt(Int32, Control)	Agrega el control especificado View a la colección en la ubicación de índice especificada.
Clear()	Quita todos los controles del objeto ControlCollection del control de servidor actual. (Heredado de ControlCollection)
Contains(Control)	Determina si el control de servidor especificado está en el objeto ControlCollection del control de servidor principal. (Heredado de ControlCollection)
CopyTo(Array, Int32)	Copia los controles secundarios almacenados en el objeto ControlCollection en un objeto Array, comenzando por la ubicación de índice especificada en Array. (Heredado de ControlCollection)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Recupera un enumerador que puede iterar por el objeto ControlCollection. (Heredado de ControlCollection)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Control)	Recupera el índice de un objeto Control especificado en la colección. (Heredado de ControlCollection)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(Control)	Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal. (Heredado de ControlCollection)
RemoveAt(Int32)	Quita un control secundario, situado en la ubicación de índice especificada, del objeto ControlCollection. (Heredado de ControlCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Compartir vía