ComponentCollection ComponentCollection ComponentCollection ComponentCollection Class

Definición

Ofrece un contenedor de solo lectura para una colección de objetos IComponent. Provides a read-only container for a collection of IComponent objects.

public ref class ComponentCollection : System::Collections::ReadOnlyCollectionBase
[System.Runtime.InteropServices.ComVisible(true)]
public class ComponentCollection : System.Collections.ReadOnlyCollectionBase
type ComponentCollection = class
    inherit ReadOnlyCollectionBase
Public Class ComponentCollection
Inherits ReadOnlyCollectionBase
Herencia
ComponentCollectionComponentCollectionComponentCollectionComponentCollection
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un ComponentCollection para enumerar una colección de personalizado BookComponent objetos.The following code example demonstrates how to use a ComponentCollection to enumerate a collection of custom BookComponent objects.

 //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.
 ref class LibraryContainer: public IContainer
 {
 private:
    ArrayList^ m_bookList;

 public:
    LibraryContainer()
    {
       m_bookList = gcnew ArrayList;
    }

    virtual void Add( IComponent^ book )
    {
       
       //The book will be added without creation of the ISite object.
       m_bookList->Add( book );
    }

    virtual void Add( IComponent^ book, String^ ISNDNNum )
    {
       for ( int i = 0; i < m_bookList->Count; ++i )
       {
          IComponent^ curObj = static_cast<IComponent^>(m_bookList->default[ i ]);
          if ( curObj->Site != nullptr )
          {
             if ( curObj->Site->Name->Equals( ISNDNNum ) )
                            throw gcnew SystemException( "The ISBN number already exists in the container" );
          }

       }
       ISBNSite^ data = gcnew ISBNSite( this,book );
       data->Name = ISNDNNum;
       book->Site = data;
       m_bookList->Add( book );
    }

    virtual void Remove( IComponent^ book )
    {
       for ( int i = 0; i < m_bookList->Count; ++i )
       {
          if ( book->Equals( m_bookList->default[ i ] ) )
          {
             m_bookList->RemoveAt( i );
             break;
          }

       }
    }


    property ComponentCollection^ Components 
    {
       virtual ComponentCollection^ get() 
       {
          array<IComponent^>^datalist = gcnew array<BookComponent^>(m_bookList->Count);
          m_bookList->CopyTo( datalist );
          return gcnew ComponentCollection( datalist );
       }

    }

    ~LibraryContainer()
    {
       for ( int i = 0; i < m_bookList->Count; ++i )
       {
          IComponent^ curObj = static_cast<IComponent^>(m_bookList->default[ i ]);
          delete curObj;

       }
       m_bookList->Clear();
    }



 };



 [STAThreadAttribute]
 int main()
    {
       LibraryContainer^ cntrExmpl = gcnew LibraryContainer;
       try
       {
          BookComponent^ book1 = gcnew BookComponent( "Wizard's First Rule","Terry Gooodkind" );
          cntrExmpl->Add( book1, "0812548051" );
          BookComponent^ book2 = gcnew BookComponent( "Stone of Tears","Terry Gooodkind" );
          cntrExmpl->Add( book2, "0812548094" );
          BookComponent^ book3 = gcnew BookComponent( "Blood of the Fold","Terry Gooodkind" );
          cntrExmpl->Add( book3, "0812551478" );
          BookComponent^ book4 = gcnew 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 ( SystemException^ e ) 
       {
          Console::WriteLine(  "Error description: {0}", e->Message );
       }

       ComponentCollection^ datalist = cntrExmpl->Components;
       IEnumerator^ denum = datalist->GetEnumerator();
       while ( denum->MoveNext() )
       {
          BookComponent^ cmp = static_cast<BookComponent^>(denum->Current);
          Console::WriteLine( "Book Title: {0}", cmp->Title );
          Console::WriteLine(  "Book Author: {0}", cmp->Author );
          Console::WriteLine(  "Book ISBN: {0}", cmp->Site->Name );
       }

return 0;
    }

//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 SystemException("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(SystemException e)
		{
			Console.WriteLine("Error description: " + 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 SystemException("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 SystemException
            Console.WriteLine("Error description: " + 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

Comentarios

Esta colección se hereda de ReadOnlyCollectionBase.This collection inherits from ReadOnlyCollectionBase. La única manera de agregar IComponent objetos a esta colección es usar el constructor de clase.The only way to add IComponent objects to this collection is to use the class constructor.

Esta colección proporciona dos propiedades de indizador, un indizador de cadenas y un indizador de enteros.This collection provides two indexer properties, a string indexer and an integer indexer. La propiedad de indizador de la cadena devuelve un componente de la colección por su nombre si el Site propiedad de un componente de la colección no es null y Name propiedad de la Site propiedad del componente coincide con el especificado cadena.The string indexer property returns a component in the collection by name if the Site property of a component in the collection is not null and the Name property of the Site property of the component matches the specified string. La propiedad de indizador entero devuelve el IComponent en el índice de la colección especificada.The integer indexer property returns the IComponent at the specified collection index. 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.The CopyTo method copies the contents of the collection to a specified array, beginning writing to the array at the specified index.

Constructores

ComponentCollection(IComponent[]) ComponentCollection(IComponent[]) ComponentCollection(IComponent[]) ComponentCollection(IComponent[])

Inicializa una nueva instancia de la clase ComponentCollection utilizando la matriz de componentes especificada. Initializes a new instance of the ComponentCollection class using the specified array of components.

Propiedades

Count Count Count Count

Obtiene el número de elementos incluidos en la instancia de ReadOnlyCollectionBase. Gets the number of elements contained in the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a un objeto ReadOnlyCollectionBase está sincronizado (es seguro para subprocesos). Gets a value indicating whether access to a ReadOnlyCollectionBase object is synchronized (thread safe).

(Inherited from ReadOnlyCollectionBase)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a un objeto ReadOnlyCollectionBase. Gets an object that can be used to synchronize access to a ReadOnlyCollectionBase object.

(Inherited from ReadOnlyCollectionBase)
InnerList InnerList InnerList InnerList

Obtiene la lista de elementos incluidos en la instancia de ReadOnlyCollectionBase. Gets the list of elements contained in the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtiene el objeto Component de la colección por el índice de colección especificado. Gets the Component in the collection at the specified collection index.

Item[String] Item[String] Item[String] Item[String]

Obtiene cualquier componente de la colección que coincida con el nombre especificado. Gets any component in the collection matching the specified name.

Métodos

CopyTo(IComponent[], Int32) CopyTo(IComponent[], Int32) CopyTo(IComponent[], Int32) CopyTo(IComponent[], Int32)

Copia toda la colección en una matriz, empezando a escribir por el índice especificado. Copies the entire collection to an array, starting writing at the specified array index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Devuelve un enumerador que recorre en iteración la instancia de ReadOnlyCollectionBase. Returns an enumerator that iterates through the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copia la totalidad de ReadOnlyCollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino. Copies the entire ReadOnlyCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

(Inherited from ReadOnlyCollectionBase)

Se aplica a

Consultar también