ViewCollection Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет контейнер коллекции, который позволяет элементу управления MultiView хранить список своих дочерних элементов управления.

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

Наследование: Object

ControlCollection
ViewCollection

Примеры

В следующем примере кода показано, как программно добавлять View элементы управления в MultiView элемент управления. После создания AddAt каждого View элемента управления метод используется для добавления View элемента управления в ViewCollection коллекцию MultiView элемента управления по указанному индексу. Индексатор Item[] используется для доступа к ID свойствам View элементов управления, хранящихся в ViewCollection коллекции, и отображает их пользователю.

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

Класс ViewCollection представляет контейнер коллекции, который позволяет элементу MultiView управления поддерживать список его дочерних элементов управления. Элемент MultiView управления может содержать только View элементы управления в качестве дочерних элементов управления.

Add Используйте метод, чтобы добавить новый View элемент управления в коллекцию ViewCollection в конце порядкового массива индекса. AddAt Используйте метод для добавления нового элемента управления в определенном расположении индекса. Item[] Используйте индексатор для получения View элемента управления из ViewCollection коллекции по указанному индексу с помощью простой нотации массива.

Конструкторы

ViewCollection(Control)

Инициализирует новый экземпляр класса ViewCollection.

Свойства

Count	Возвращает количество серверных элементов управления в объекте ControlCollection указанного ASP.NET серверного элемента управления. (Унаследовано от ControlCollection)
IsReadOnly	Получает значение, показывающее, является ли объект ControlCollection доступным только для чтения. (Унаследовано от ControlCollection)
IsSynchronized	Возвращает значение, обозначающее, является ли объект ControlCollection синхронизированным. (Унаследовано от ControlCollection)
Item[Int32]	Возвращает ссылку на элемент управления View по указанному расположению индекса в коллекции ViewCollection.
Owner	Возвращает ASP.NET серверный элемент управления, которому принадлежит объект ControlCollection. (Унаследовано от ControlCollection)
SyncRoot	Возвращает объект, который может быть использован для синхронизации доступа к коллекции элементов управления. (Унаследовано от ControlCollection)

Методы

Add(Control)	Добавляет указанный элемент управления View в коллекцию.
AddAt(Int32, Control)	Добавляет указанный элемент управления View в коллекцию по указанному расположению индекса.
Clear()	Удаляет все элементы управления из объекта ControlCollection текущего серверного элемента управления. (Унаследовано от ControlCollection)
Contains(Control)	Определяет наличие указанных серверных элементов управления в объекте ControlCollection родительского серверного элемента управления. (Унаследовано от ControlCollection)
CopyTo(Array, Int32)	Копирует дочерние элементы управления, хранимые в объекте ControlCollection, в объект Array, начиная с индекса, указанного в Array. (Унаследовано от ControlCollection)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Получает перечислитель, который может выполнять проход по объекту ControlCollection. (Унаследовано от ControlCollection)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(Control)	Извлекает индекс указанного объекта Control в коллекции. (Унаследовано от ControlCollection)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(Control)	Удаляет указанный серверный элемент управления из объекта ControlCollection родительского серверного элемента управления. (Унаследовано от ControlCollection)
RemoveAt(Int32)	Удаляет дочерний элемент управления из объекта ControlCollection по указанному индексу. (Унаследовано от ControlCollection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

Применяется к