1-Crear una coleccin mediante la clase de coleccin de Visual Basic Declare y cree una variable de Visual Basic Collection,

tal como se muestra en e l ejemplo siguiente. Dim sampleVisualBasicColl As New Microsoft.VisualBasic.Collection() La coleccin de sampleVisualBasicColl puede aceptar elementos de cualquier tipo de datos. 2-Utilice Add (Mtodo, objeto Collection) para agregar elementos a la coleccin. El ejemplo siguiente crea cuatro elementos String y los agrega a la coleccin. Crea u n valor String nico como clave para cada nuevo elemento y lo pasa al mtodo Add. Dim item1, item2, item3, item4 As String item1 = "Items" item2 = "In" item3 = "A" item4 = "Collection" sampleVisualBasicColl.Add(item1, "firstkey") sampleVisualBasicColl.Add(item2, "secondkey") sampleVisualBasicColl.Add(item3, "thirdkey") sampleVisualBasicColl.Add(item4, "fourthkey") El argumento Key es opcional en una coleccin de Visual Basic. 3-Si desea quitar un elemento de la coleccin, puede utilizar Remove (Mtodo, obj eto Collection) identificando el elemento por su ndice posicional o por su clave opcional. Esto se ilustra en el siguiente ejemplo: ' Remove the first element of the Visual Basic collection. sampleVisualBasicColl.Remove(1) ' Remove the element with the key "secondkey". sampleVisualBasicColl.Remove("secondkey") Tenga en cuenta que al quitar un elemento de Visual Basic Collection, los va lores del ndice se numeran desde 1 hasta el valor de Count (Propiedad, objeto Col lection). Para utilizar For Each...Next para procesar los elementos de la coleccin de Visua l Basic 1- Declare una variable del tipo almacenado en la coleccin. Para obtener el ej emplo anterior, declare una variable de tipo String, tal como muestra el ejemplo siguiente. ' Insert code from the preceding example. Dim aString As String 2- Utilice Instruccin For Each...Next (Visual Basic) para examinar cada elemen to de la coleccin. El ejemplo siguiente busca una cadena determinada y la muestra si la encuentra. For Each aString in sampleVisualBasicColl If aString = "Collection" Then MsgBox(aString) End If Next aString

Para crear una coleccin mediante una clase de coleccin genrica 1- Declare y cree una variable de .NET Framework System.Collections.Generic.D ictionary, tal como se muestra en el ejemplo siguiente. Dim sampleGenericColl As New System.Collections.Generic.Dictionary(Of String , String) La variable sampleGenericColl contiene una coleccin de tipo seguro que slo ace pta elementos y claves de tipo String. 2- Utilice el mtodo System.Collections.Generic.Dictionary.Add( para agregar el ementos a la coleccin. El ejemplo siguiente crea cuatro elementos String y los ag rega a la coleccin. Crea un valor String nico como clave para cada nuevo elemento y lo pasa al mtodo Add. Dim item1, item2, item3, item4 As String item1 = "Items" item2 = "In" item3 = "A" item4 = "Collection" sampleGenericColl.Add("firstkey", item1) sampleGenericColl.Add("secondkey", item2) sampleGenericColl.Add("thirdkey", item3) sampleGenericColl.Add("fourthkey", item4) Se requiere el argumento Key en esta coleccin genrica. Para quitar un elemento de la coleccin, utilice el mtodo System.Collections.Ge neric.IDictionary.Remove(. Debe proporcionar la clave para identificar el elemen to que se va a quitar. Esto se ilustra en el siguiente ejemplo: If Not sampleGenericColl.Remove("thirdkey") ' Insert code to handle "thirdkey" not found in collection. End If Puede utilizar una instruccin For Each...Next para recorrer en iteracin y proc esar los elementos de una coleccin, como muestra el procedimiento siguiente. Para utilizar For Each...Next para procesar los elementos de la coleccin genrica 1- Declare una variable del tipo almacenado en la coleccin. Para obtener el ej emplo anterior, declare una variable de tipo String, tal como muestra el ejemplo siguiente. ' Insert code from the preceding example. Dim aPair As KeyValuePair(Of String, String) Utilice Instruccin For Each...Next (Visual Basic) para examinar cada elemento de la coleccin. El ejemplo siguiente busca una cadena determinada y la muestra s i la encuentra. For Each aPair In sampleGenericColl If aPair.Value = "Items" Then MsgBox(aPair.Key & " -- " & aPair.Value) End If Next aPair

Utilice Add (Mtodo, objeto Collection) y especifique el elemento por su Key. object.Add(Item, Key [, {Before | After}]) Por ejemplo, para agregar un objeto de orden de trabajo a una coleccin de rden es de trabajo utilizando como clave la propiedad ID de la orden de trabajo, pued e realizar la siguiente llamada: workOrders.Add(woNew, woNew.ID) La llamada anterior supone que la propiedad ID es una cadena. Si es un nmero (por ejemplo, un entero Long ), utilice su mtodo ToString para convertirlo en el valor String necesario para el argumento Key. workOrders.Add(woNew, woNew.ID.ToString()) El uso de una clave es opcional. Si no desea asociar una clave al objeto de su coleccin, puede agregarlo sin una clave. workOrders.Add(woNew) Puede utilizar los argumentos Before y After para mantener una coleccin orden ada de objetos. El miembro que se agrega se coloca en la coleccin antes o despus d el miembro identificado por el argumento Before o After respectivamente. Por eje mplo, si estable Before igual a 1, se inserta un elemento al principio de la col eccin porque los objetos Collection estn basados en 1. workOrders.Add(woNew, woNew.ID, 1) De forma similar, el argumento After agrega un elemento despus del ndice espec ificado. El siguiente ejemplo agrega un tercer elemento. workOrders.Add(woNew, woNew.ID,,2) Se puede especificar un valor para Before o para After, pero no para ambos. Para eliminar un elemento de una coleccin Utilice Remove (Mtodo, objeto Collection) y especifique el elemento por su In dex o su Key. object.Remove({Index | Key}) El argumento Index es la posicin del elemento que desea eliminar. El argument o Key es la misma cadena que ha utilizado para agregar el elemento a la coleccin. Si la clave del tercer elemento de una coleccin es "W017493", puede utilizar cua lquiera de las dos instrucciones siguientes para eliminarlo. workOrders.Remove(3) workOrders.Remove("W017493") Para eliminar todos los elementos de una coleccin Use Clear (Mtodo, objeto Collection). object.Clear() El mtodo Clear vaca la coleccin.

Para recuperar un elemento de una coleccin Utilice Item (Propiedad, objeto Collection) y especifique el elemento por su Index o su Key. variable = object.Item({Index | Key}) Igual que con el mtodo Remove, el argumento Index es la posicin del elemento e n la coleccin y el argumento Key es la cadena utilizada al agregar el elemento. C on el mismo ejemplo del mtodo Remove, cualquiera de las instrucciones siguientes recupera el tercer elemento de la coleccin: woCurrent = workOrders.Item(3) woCurrent = workOrders.Item("W017493") Nota Si utiliza nmeros como claves, debe utilizar sus mtodos ToString para convertirlos en las cadenas antes de pasarlos al mtodo Add o Remove o a la propiedad Item. Un objeto de Visual Basic Collection supone siempre que un nmero es un ndice, en vez de una cadena de clave. Si conoce operador ccin sin escribir la clave en el tiempo de compilacin, puede utilizar alternativamente el (!) de acceso a diccionario para tener acceso a un elemento de la cole incluir la clave entre comillas o parntesis. La llamada anterior se puede del modo siguiente.

woCurrent = workOrders!W017493

Definir colecciones en clases propias Cree una variable pblica para que acte como una coleccin para sus objetos. Public Class widgetRepository Public widgetColl As New Microsoft.VisualBasic.Collection() ' Insert code to implement additional functionality. End Class La clase widgetRepository tiene ahora una coleccin pblica a la que se pueden a gregar objetos widget. Puede utilizar Instruccin For Each...Next (Visual Basic) p ara procesar los elementos de coleccin, como muestra el cdigo siguiente. For Each aWidget As widget In widgetColl ' Insert code to process widgetColl elements Next aWidget La coleccin widgetColl definida en el ejemplo anterior no es con establecimie nto inflexible de tipos, lo que significa que puede agregar cualquier tipo de ob jeto, no slo objetos widget. Esto puede conducir a problemas de seguridad de tipo s. Por ejemplo, suponga que agrega String a la coleccin, como en el cdigo siguient e. Dim notWidget As String = "This is not a widget object!" widgetColl.Add(notWidget) Si hace esto, el bucle For Each del procedimiento anterior produce una excep

cin ArgumentException en tiempo de ejecucin porque un elemento de la coleccin no es de tipo widget. Se recomienda definir una clase genrica cuando se desea garantizar la segurid ad de tipos. Para obtener ms informacin y un ejemplo, consulte Cmo: Definir colecci ones con seguridad de tipos.