ViewCollection Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Representa um contentor de recolha que permite a um MultiView controlo manter uma lista dos seus controlos 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 seguinte demonstra como adicionar View programaticamente controlos a um MultiView controlo. Após a criação de cada View controlo, o AddAt método é usado para adicionar o View controlo à ViewCollection coleção do MultiView controlo no índice especificado. O Item[] indexador é usado para aceder às ID propriedades dos View controlos armazenados na ViewCollection coleção e exibi-los ao utilizador.

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

Observações

A ViewCollection classe representa um contentor de recolha que permite a um MultiView controlo manter uma lista dos seus controlos filhos. Um MultiView controlo pode conter apenas View controlos como controlos filhos.

Use o Add método para adicionar um novo View controlo à ViewCollection coleção no final de um array de índice ordinal. Use o AddAt método para adicionar um novo controlo numa localização específica do índice. Use o Item[] indexador para obter um View controlo a partir da ViewCollection coleção num índice especificado, usando notação simples de array.

Construtores

Name Description
ViewCollection(Control)

Inicializa uma nova instância da ViewCollection classe.

Propriedades

Name Description
Count

Obtém o número de controlos de servidor no objeto ControlCollection para o controlo ASP.NET de servidor especificado.

(Herdado de ControlCollection)
IsReadOnly

Recebe um valor que indica se o ControlCollection objeto é apenas de leitura.

(Herdado de ControlCollection)
IsSynchronized

Recebe um valor que indica se o ControlCollection objeto está sincronizado.

(Herdado de ControlCollection)
Item[Int32]

Recebe uma referência ao View controlo na localização do índice especificada na ViewCollection coleção.
Owner

Obtém o controlo do servidor ASP.NET ao qual pertence o objeto ControlCollection.

(Herdado de ControlCollection)
SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controlos.

(Herdado de ControlCollection)

Métodos

Name Description
Add(Control)

Adiciona o controlo especificado View à coleção.
AddAt(Int32, Control)

Adiciona o controlo especificado View à coleção na localização do índice especificada.
Clear()

Remove todos os controlos do objeto do ControlCollection controlo do servidor atual.

(Herdado de ControlCollection)
Contains(Control)

Determina se o controlo do servidor especificado está no objeto do ControlCollection controlo do servidor pai.

(Herdado de ControlCollection)
CopyTo(Array, Int32)

Copia os controlos filhos armazenados no ControlCollection objeto para um Array objeto, começando na localização do índice especificada 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 através do ControlCollection objeto.

(Herdado de ControlCollection)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Control)

Recupera o índice de um objeto especificado Control na coleção.

(Herdado de ControlCollection)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(Control)

Remove o controlo do servidor especificado do objeto do controlo ControlCollection do servidor pai.

(Herdado de ControlCollection)
RemoveAt(Int32)

Remove um controlo filho, na localização do índice especificado, do ControlCollection objeto.

(Herdado de ControlCollection)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também