ComponentCollection Clase
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í.
Ofrece un contenedor de solo lectura para una colección de objetos IComponent.
public ref class ComponentCollection : System::Collections::ReadOnlyCollectionBase
public ref class ComponentCollection
public class ComponentCollection : System.Collections.ReadOnlyCollectionBase
public class ComponentCollection
[System.Runtime.InteropServices.ComVisible(true)]
public class ComponentCollection : System.Collections.ReadOnlyCollectionBase
type ComponentCollection = class
inherit ReadOnlyCollectionBase
type ComponentCollection = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentCollection = class
inherit ReadOnlyCollectionBase
Public Class ComponentCollection
Inherits ReadOnlyCollectionBase
Public Class ComponentCollection
- Herencia
- Herencia
-
ComponentCollection
- Atributos
En el ejemplo de código siguiente se muestra cómo usar un ComponentCollection para enumerar una colección de objetos personalizados BookComponent
.
//This code segment implements the IContainer interface. The code segment
//containing the implementation of ISite and IComponent can be found in the documentation
//for those interfaces.
//Implement the LibraryContainer using the IContainer interface.
class LibraryContainer : IContainer
{
private ArrayList m_bookList;
public LibraryContainer()
{
m_bookList = new ArrayList();
}
public virtual void Add(IComponent book)
{
//The book will be added without creation of the ISite object.
m_bookList.Add(book);
}
public virtual void Add(IComponent book, string ISNDNNum)
{
for(int i =0; i < m_bookList.Count; ++i)
{
IComponent curObj = (IComponent)m_bookList[i];
if(curObj.Site != null)
{
if(curObj.Site.Name.Equals(ISNDNNum))
throw new ArgumentException("The ISBN number already exists in the container");
}
}
ISBNSite data = new ISBNSite(this, book);
data.Name = ISNDNNum;
book.Site = data;
m_bookList.Add(book);
}
public virtual void Remove(IComponent book)
{
for(int i =0; i < m_bookList.Count; ++i)
{
if(book.Equals(m_bookList[i]))
{
m_bookList.RemoveAt(i);
break;
}
}
}
public ComponentCollection Components
{
get
{
IComponent[] datalist = new BookComponent[m_bookList.Count];
m_bookList.CopyTo(datalist);
return new ComponentCollection(datalist);
}
}
public virtual void Dispose()
{
for(int i =0; i < m_bookList.Count; ++i)
{
IComponent curObj = (IComponent)m_bookList[i];
curObj.Dispose();
}
m_bookList.Clear();
}
static void Main(string[] args)
{
LibraryContainer cntrExmpl = new LibraryContainer();
try
{
BookComponent book1 = new BookComponent("Wizard's First Rule", "Terry Gooodkind");
cntrExmpl.Add(book1, "0812548051");
BookComponent book2 = new BookComponent("Stone of Tears", "Terry Gooodkind");
cntrExmpl.Add(book2, "0812548094");
BookComponent book3 = new BookComponent("Blood of the Fold", "Terry Gooodkind");
cntrExmpl.Add(book3, "0812551478");
BookComponent book4 = new BookComponent("The Soul of the Fire", "Terry Gooodkind");
//This will generate exception because the ISBN already exists in the container.
cntrExmpl.Add(book4, "0812551478");
}
catch (ArgumentException e)
{
Console.WriteLine("Unable to add books: " + e.Message);
}
ComponentCollection datalist =cntrExmpl.Components;
IEnumerator denum = datalist.GetEnumerator();
while(denum.MoveNext())
{
BookComponent cmp = (BookComponent)denum.Current;
Console.WriteLine("Book Title: " + cmp.Title);
Console.WriteLine("Book Author: " + cmp.Author);
Console.WriteLine("Book ISBN: " + cmp.Site.Name);
}
}
}
'This code segment implements the IContainer interface. The code segment
'containing the implementation of ISite and IComponent can be found in the documentation
'for those interfaces.
'Implement the LibraryContainer using the IContainer interface.
Class LibraryContainer
Implements IContainer
Private m_bookList As ArrayList
Public Sub New()
m_bookList = New ArrayList()
End Sub
Public Sub Add(ByVal book As IComponent) Implements IContainer.Add
'The book will be added without creation of the ISite object.
m_bookList.Add(book)
End Sub
Public Sub Add(ByVal book As IComponent, ByVal ISNDNNum As String) Implements IContainer.Add
Dim i As Integer
Dim curObj As IComponent
For i = 0 To m_bookList.Count - 1
curObj = CType(m_bookList(i), IComponent)
If curObj.Site IsNot Nothing Then
If (curObj.Site.Name.Equals(ISNDNNum)) Then
Throw New ArgumentException("The ISBN number already exists in the container")
End If
End If
Next i
Dim data As ISBNSite = New ISBNSite(Me, book)
data.Name = ISNDNNum
book.Site = data
m_bookList.Add(book)
End Sub
Public Sub Remove(ByVal book As IComponent) Implements IContainer.Remove
Dim i As Integer
Dim curComp As BookComponent = CType(book, BookComponent)
For i = 0 To m_bookList.Count - 1
If (curComp.Equals(m_bookList(i)) = True) Then
m_bookList.RemoveAt(i)
Exit For
End If
Next i
End Sub
Public ReadOnly Property Components() As ComponentCollection Implements IContainer.Components
Get
Dim datalist(m_bookList.Count - 1) As IComponent
m_bookList.CopyTo(datalist)
Return New ComponentCollection(datalist)
End Get
End Property
Public Overridable Sub Dispose() Implements IDisposable.Dispose
Dim i As Integer
For i = 0 To m_bookList.Count - 1
Dim curObj As IComponent = CType(m_bookList(i), IComponent)
curObj.Dispose()
Next i
m_bookList.Clear()
End Sub
Public Shared Sub Main()
Dim cntrExmpl As LibraryContainer = New LibraryContainer()
Try
Dim book1 As BookComponent = New BookComponent("Wizard's First Rule", "Terry Gooodkind")
cntrExmpl.Add(book1, "0812548051")
Dim book2 As BookComponent = New BookComponent("Stone of Tears", "Terry Gooodkind")
cntrExmpl.Add(book2, "0812548094")
Dim book3 As BookComponent = New BookComponent("Blood of the Fold", "Terry Gooodkind")
cntrExmpl.Add(book3, "0812551478")
Dim book4 As BookComponent = New BookComponent("The Soul of the Fire", "Terry Gooodkind")
'This will generate an exception, because the ISBN already exists in the container.
cntrExmpl.Add(book4, "0812551478")
Catch e As ArgumentException
Console.WriteLine("Unable to add books: " + e.Message)
End Try
Dim datalist As ComponentCollection = cntrExmpl.Components
Dim denum As IEnumerator = datalist.GetEnumerator()
While (denum.MoveNext())
Dim cmp As BookComponent = CType(denum.Current, BookComponent)
Console.WriteLine("Book Title: " + cmp.Title)
Console.WriteLine("Book Author: " + cmp.Author)
Console.WriteLine("Book ISBN: " + cmp.Site.Name)
End While
End Sub
End Class
Esta colección hereda de ReadOnlyCollectionBase. La única manera de agregar IComponent objetos a esta colección es usar el constructor de clase .
Esta colección proporciona dos propiedades de indexador, un indizador de cadena y un indizador entero. La propiedad del indexador de cadena devuelve un componente de la colección por nombre si la Site propiedad de un componente de la colección no null
es y la Name propiedad de la Site propiedad del componente coincide con la cadena especificada. La propiedad integer indexador devuelve en IComponent el índice de colección especificado. El CopyTo método copia el contenido de la colección en una matriz especificada, empezando a escribir en la matriz en el índice especificado.
Component |
Inicializa una nueva instancia de la clase ComponentCollection utilizando la matriz de componentes especificada. |
Count |
Obtiene el número de elementos contenidos en la instancia de ReadOnlyCollectionBase. (Heredado de ReadOnlyCollectionBase) |
Inner |
Obtiene la lista de elementos incluidos en la instancia de ReadOnlyCollectionBase. (Heredado de ReadOnlyCollectionBase) |
Item[Int32] |
Obtiene el objeto Component de la colección por el índice de colección especificado. |
Item[String] |
Obtiene cualquier componente de la colección que coincida con el nombre especificado. |
Copy |
Copia toda la colección en una matriz, empezando a escribir por el índice especificado. |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
Get |
Devuelve un enumerador que recorre en iteración la instancia de ReadOnlyCollectionBase. (Heredado de ReadOnlyCollectionBase) |
Get |
Sirve como la función hash predeterminada. (Heredado de Object) |
Get |
Obtiene el Type de la instancia actual. (Heredado de Object) |
Memberwise |
Crea una copia superficial del Object actual. (Heredado de Object) |
To |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
ICollection. |
Copia la totalidad de ReadOnlyCollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino. (Heredado de ReadOnlyCollectionBase) |
ICollection. |
Obtiene un valor que indica si el acceso a un objeto ReadOnlyCollectionBase está sincronizado (es seguro para subprocesos). (Heredado de ReadOnlyCollectionBase) |
ICollection. |
Obtiene un objeto que se puede utilizar para sincronizar el acceso a un objeto ReadOnlyCollectionBase. (Heredado de ReadOnlyCollectionBase) |
Cast<TResult>(IEnumerable) |
Convierte los elementos de IEnumerable en el tipo especificado. |
Of |
Filtra los elementos de IEnumerable en función de un tipo especificado. |
As |
Habilita la paralelización de una consulta. |
As |
Convierte una interfaz IEnumerable en IQueryable. |
Comentarios de .NET
.NET es un proyecto de código abierto. Selecciona un vínculo para proporcionar comentarios: