ViewCollection Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um contêiner de coleção que permite que um controle MultiView mantenha uma lista de seus controles filhos.

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

Herança: Object

ControlCollection
ViewCollection

Exemplos

O exemplo de código a seguir demonstra como adicionar View programaticamente controles a um MultiView controle. Depois que cada View controle é criado, o AddAt método é usado para adicionar o View controle à ViewCollection coleção do MultiView controle no índice especificado. O Item[] indexador é usado para acessar as ID propriedades dos View controles armazenados na ViewCollection coleção e exibi-los ao usuário.

<%@ 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>

Comentários

A ViewCollection classe representa um contêiner de coleção que permite que um MultiView controle mantenha uma lista de seus controles filho. Um MultiView controle pode conter apenas View controles como controles filho.

Use o Add método para adicionar um novo View controle à ViewCollection coleção no final de uma matriz de índice ordinal. Use o AddAt método para adicionar um novo controle em um local de índice específico. Use o Item[] indexador para obter um View controle da ViewCollection coleção em um índice especificado, usando notação de matriz simples.

Construtores

ViewCollection(Control)

Inicializa uma nova instância da classe ViewCollection.

Propriedades

Count	Obtém o número de controles de servidor no objeto ControlCollection para o controle de servidor ASP.NET especificado. (Herdado de ControlCollection)
IsReadOnly	Obtém um valor que indica se o objeto ControlCollection é somente leitura. (Herdado de ControlCollection)
IsSynchronized	Obtém um valor que indica se o objeto ControlCollection está sincronizado. (Herdado de ControlCollection)
Item[Int32]	Obtém uma referência ao controle View no local do índice especificado na coleção ViewCollection.
Owner	Obtém o controle de servidor ASP.NET ao qual o objeto ControlCollection pertence. (Herdado de ControlCollection)
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels. (Herdado de ControlCollection)

Métodos

Add(Control)	Adiciona o controle View à coleção.
AddAt(Int32, Control)	Adiciona o controle View especificado à coleção no local do índice especificado.
Clear()	Remove todos os controles do objeto ControlCollection do controle dde servidor atual. (Herdado de ControlCollection)
Contains(Control)	Determina se o controle de servidor especificado está no objeto ControlCollection do controle de servidor pai. (Herdado de ControlCollection)
CopyTo(Array, Int32)	Copia os controles filho armazenados no objeto ControlCollection para um objeto Array, começando no local do índice especificado no Array. (Herdado de ControlCollection)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Recupera um enumerador que pode iterar pelo objeto ControlCollection. (Herdado de ControlCollection)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Control)	Recupera o índice de um objeto Control especificado na coleção. (Herdado de ControlCollection)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(Control)	Remove o servidor especificado do objeto ControlCollection do controle de servidor pai. (Herdado de ControlCollection)
RemoveAt(Int32)	Remove um controle filho, no local do índice especificado, do objeto ControlCollection. (Herdado de ControlCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Compartilhar via