1.8 Añadir una DataGridView y BindingNavigator Controls

VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 29
Pasar de ADO a ADO.NET
Al usar los métodos DataSet.WriteXml y DataSet.WriteXmlSchema para persistir DataSets
en archivos locales, se ve que el esquema Customers DataSet, que difiere enormemente de
la versión en tiempo de diseño, ocupa 9,31 KBytes y el documento XML ocupa 37,3 KBytes.
Más adelante en este libro, se incluye código para guardar el esquema del juego de datos
Northwind Customers. El esquema guardado no se puede abrir en ventana principal del
proyecto.
1.8 Añadir una DataGridView y BindingNavigator
Controls
Al abrir el Form1 y el panel Orígenes de datos cambia el aspecto de los nodos DataSource.
Por defecto, el icono de la tabla de datos Customers representa un DataGridView.
Arrastrando el nodo de la tabla Customers desde el panel Orígenes de datos hasta el
Form1 por defecto del proyecto, se autogeneran cuatro componentes en la bandeja que
hay bajo el diseñador y se añaden los controles DataGridView y DataNavigator a un formulario que ha crecido considerablemente, tal como muestra la siguiente figura.
Aquí están las descripciones de las cuatro componentes de la bandeja que muestra la
figura anterior:
)
NorthwindDataSet es la referencia del formulario a la fuente de datos para el formulario NorthwindDataSource.xsd.
29
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 30
Bases de datos con Visual Basic
)
)
)
CustomersBindingSource es un objeto BindingSource basado en formulario, el cual
unifica la unión y la navegación de datos de control y fiilas de datos para la tabla
de datos Customers, al proporcionar acceso directo al objeto BindingManager. Para
facilitar a los programadores de VB6 el cambio a ADO.NET 2.0, las BindingSources
tienen propiedades y métodos que simulan a los objetos ADODB.Recordset.
Ejemplo de ellos son las propiedades AllowEdit, AllowAddNew, y AllowRemove
(delete) y los correspondientes métodos AddNew, CancelNew, EndNew, Edit, CancelEdit, y EndEdit. Los conocidos métodos MoveFirst, MoveLast, MoveNext, y MovePrevious se ocupan de la navegación por las filas. Hacer posible la navegación significa vincular un DataGridView o añadir otros controles para manipular la
BindingSource.
CustomersTableAdapter es el envoltorio del formulario para cualquier objeto SqlDataAdapter que llene la tabla de datos NorthwindDataSet´s Customers invocando el
método CustomersTableAdapter.Fill. Los métodos Update, Insert, y Delete envían
cambios en el juego de datos al servidor de la base de datos. La propiedad CustomersTableAdapter.Adapter permite acceder al SqlDataAdapter subyacente.
CustomersBindingNavigator es un control habitual de ToolStrip que simula el botón
VCR y otros de un ADODB.DataControl. Vincular el CustomersBindingNavigator con
la CustomersBindingSource permite invocar con los botones los métodos Move...,
AddNew, y Cancel.... Por defecto, los BindingNavigators suelen estar en la parte
superior del formulario. Al ejecutar el formulario se puede arrastrar el BindingNavigator a una posición más cómoda, en la parte inferior del formulario, o también se le puede dar el valor Bottom a la propiedad Dock del DataNavigator en el
diseñador de proyecto.
DataComponents, DataConnectors, y DataNavigators son componentes y controles nuevos
de ADO.NET 2.0 que substituyen los DataConnections y DataAdapters basados en formulario de ADO.NET 1.x. Las fuentes de datos de VS 2005 crean automáticamente relaciones
entre los juegos de datos de diferentes tablas, que requieren una intervención manual previa. Los DataConnectors simplifican el código para navegar por las tablas de datos. El archivo DataSet.vb contiene clases, interfaces y tratadores de eventos para las componentes de
datos.
El último paso en el proceso de autogeneración del formulario de datos 2005 es añadir el método
CustomersComponent.Fill al evento Form1_Load; y código para salvar los cambios del DataSet no se
añade automáticamente al evento bindingNavigatorSaveItem_Click, debido a la complejidad del
código cuando el juego de datos contiene tablas múltiples. Salvar cambios múltiples en
tablas madre y derivadas requiere secuencias para inserciones, actualizaciones y borrados, a fin de mantener la integridad referencial.
Private Sub Form1_Load(ByVal sender As System.Object,
¨
ByVal e As System.EventArgs) Handles MyBase.Load
'TODO: This line of code loads data into the 'NorthwindDataSet.Customers' table.
'You can move, or remove it, as needed.
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
End Sub
30
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 31
Pasar de ADO a ADO.NET
Private Sub bindingNavigatorSaveItem_Click(ByVal sender As System.Object,
ByVal e As System.EventArgs) Handles bindingNavigatorSaveItem.Click
Me.CustomersBindingSource.EndEdit()
Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
End Sub
La siguiente figura muestra el formulario final después de reducir el tamaño, ampliar
el control de DataGridView para llenar el espacio disponible y pulsar <F5> para crear,
depurar y ejecutar el proyecto.
La CustomersDataGridView está vinculada a la tabla Customers y se puede editar por
defecto. Los cambios que se hagan en la DataGridView no se validan en la tabla hasta
que no se pulsa el botón Save Data.
Para facilitar la edición, el ancho de columna se puede adaptar automáticamente al contenido definiendo para la propiedad AutoSizeColumnsMode de DataGridView el valor
AllCells o DisplayedCells, que añade una barra de desplazamiento horizontal al control.
1.9 Persistir y reabrir el juego de datos
El manejador de eventos del proyecto frmDataGridView_Load incluye el siguiente código para salvar el documento de datos XML NorthwindDataSet y el esquema solo. Se
puede añadir código parecido después de la última invocación DataComponent.Fill o
DataAdapter.Fill de cualquier proyecto para persistir su juego de datos.
Private Sub Form1_Load(ByVal sender As System.Object,
¨ ByVal e As System.EventArgs) Handles MyBase.Load
'TODO: This line of code loads data into the 'NorthwindDataSet.Customers' table.
'You can move, or remove it, as needed.
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
Dim strPath As String = Application.StartupPath
With Me.NorthwindDataSet
.WriteXml(strPath + "CustsNoSchema.xml", XmlWriteMode.IgnoreSchema)
31
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 32
Bases de datos con Visual Basic
.WriteXml(strPath + "CustsWithSchema.xml", XmlWriteMode.WriteSchema)
.WriteXmlSchema(strPath + "CustsSchema.xsd")
End With
End Sub
Persistiendo el DataSet como documento XML, sin el esquema incrustado, permite dar
soporte a los usuarios sin conexión, cargando de nuevo el DataSet del archivo. La sentencia siguiente se puede substituir por Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers) cuando el usuario está desconectado:
Me.NorthwindDataSet.ReadXml(strPath + CustsNoSchema.xml , XmlReadMode.Auto)
El escenario en el mundo real para persistir y cargar de nuevo un juego de datos es mucho
más complejo que lo que hemos visto aquí. En capítulos posteriores se describe cómo salvar
y cargar de nuevo los cambios pendientes del DataSet que no se han pasado a las tablas
base. El argumento XmlReadMode.Auto aparece por defecto, así que incluirlo es opcional.
1.10 Cambiar de un DataViewGrid a un Details
Form
La combinación por defecto de los controles DataViewGrid y DataNavigator acelera la
creación de un formulario utilizable. De todos modos, un DataNavigator es mucho más
útil para crear un formulario de detalles que muestre en pantalla los valores de columna en cuadros de texto u otros controles vinculados, como selectores de datos DateTime
y cuadros de verificación para valores booleanos.
La ventana Data Sources facilita el cambio de la DataGridView a un formulario de detalle. Borre el control DataGridView, muestre la ventana Orígenes de datos, abra la lista desplegable para la tabla de datos, y seleccione Detalles como se muestra en la siguiente
figura.
Arrastre el icono DataTable hasta el formulario para añadir automáticamente una
columna de etiquetas con controles asociados de vinculación de datos (cuadros de texto
en este ejemplo) al formualrio. La siguiente figura, que es una versión modificada del
proyecto GeneratedDataGridView, muestra las etiquetas y los cuadros de texto reordena-
32
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 33
Pasar de ADO a ADO.NET
dos para reducir la altura del formulario.
1.11 Añadir un control de vínculo de datos
relacionado
Al panel Orígenes de datos se le puede añadir una tabla relacionada y después un control, como DataGridView, que se puede vincular al BindingAdapter relacionado. Para
añadir un control relacionado OrdersDataGridView a una copia del proyecto GeneratedDetailView.sln, Debe realiar los siguientes pasos:
1. Copie y pege la carpeta GeneratedDetailView y renombre la nueva carpeta como
OrdersDetailView. No renombre el proyecto.
2. Pulse <F5> para crear y compilar el proyecto. Corrija cualquier error de nombre
que detecte el depurador.
3. Abra la ventana Orígenes de datos y pulse el botón del ayudante Configurar Dataset
con el asistente para abrir la página Elija los objetos de la base de datos.
4. Expandir el árbol Tablas y seleccione la casilla de verificación de la tabla Orders.
Pulse el botón Finalizar. De ese modo se añade en panel Orígenes de datos un nodo
relacional Orders a la tabla Customers y un nodo individual Orders (ver siguiente
figura).
5. Con DataGridView seleccionado en la lista desplegable, arrastre el nodo Orders relacionado por debajo de los cuadros de texto vinculados del formulario para autogenerar un control OrdersDataGridView.
6. Ajuste el tamaño y la posición de los controles y defina para la propiedad OrdersDataGridView.AutoSizeRowsMode el valor DisplayedCells. Opcionalmente se
puede modificar la propiedad Text del formulario para reflejar el cambio en el
diseño.
33
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 34
Bases de datos con Visual Basic
7. Pulse <F5> para crear y ejecutar el proyecto. El formulario aparecerá tal como
muestra la siguiente figura.
Arrastrando el nodo relacionado de la tabla Orders hasta el formulario se añade un
OrdersTableAdapter y OrdersBindingSource a la bandeja, y el control OrdersDataGridView
al formulario. El valor de la propiedad OrdersDataGridView del control DataSource es
OrdersBindingSource.
34
VisualBasic2005_01.qxp
02/08/2007
16:11
PÆgina 35
Pasar de ADO a ADO.NET
La propiedad OrdersBindingSource tiene el valor CustomersBindingSource y el valor de la
propiedad DataMember es FK_Orders_Customers, el cual es la relación de clave foránea
en el campo CustomerID entre las tablas de Customers y Orders. Para verificar las propiedades de FK_Orders_Customers debe abrir el NorthwindDataSet.xsd en la ventana
principal, pulsar con el botón secundario la línea de relación entre las tablas Customers
y Orders, y seleccionar Editar relación para abrir el cuadro de diálogo Relación (ver figura siguiente).
Las relaciones que se definen añadiendo tablas relacionadas a la ventana Orígenes de datos
no refuerzan la integridad referencial por defecto. Hay que cambiar el valor por defecto de
la propiedad Sólo relación a uno de los otros valores para mantener la integridad referencial. También se puede especificar Cascade u otras opciones para las reglas actualización,
eliminación, y aceptación o rechazo.
35
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 37
CAPÍTULO 2
Las novedades de ADO.NET 2.0
En este capítulo trataremos los nuevos objetos de ADO.NET 2.0 y los métodos, propiedades y eventos utilizados con ellos. De la misma forma que el capítulo anterior, este
capítulo empieza con unas descripciones de los nuevos objetos en tiempo de ejecución,
como DbProviderFactory y SqlBulkCopy, con los correspondientes ejemplos de código
para crear y manejar los nuevos objetos. El capítulo continúa com más ejemplos avanzados de las componentes y controles de ADO.NET 2.0 para los formularios de
Windows, que se pueden agragar con la ayuda de diseñadores: DataTables, BindingSources, BindingNavigators y DataGridViews.
Todos los ejemplos de código SQLServer de este capítulo se pueden ejecutar con SQLServer 2000, SQLServer 2005 o SQLServer 2005 Express Edition (SQLX) y nencesitan los
privilegios del administrador del sistema.
Si trabajamos con SQLX, deberemos cambiar la cadena de conexión de cada proyecto de localhost a .\SQLEXPRESS.
2.1 Los objetos de formulario
Este libro define un objeto en tiempo de ejecución como un tipo de objeto no visual,
relacionado con los datos que se genera sin la ayuda de los múltiples asistentes. Los
objetos en tiempo de ejecución de ADO.NET 2.0 se crean escribiendo código VB.NET
2005 sin la ayuda de los ayudantes de tiempo-diseño de VS 2005 ni código autogenerado. Microsoft ha dedicado una parte importante del esfuerzo invertido en el desarrollo
de VS 2005 y ADO.NET 2.0 en simplificar con arrastrar y colocar la creación de formularios básicos Windows y Web de vinculación de datos.
Otro aspecto que se ha cuidado ha sido dar soporte a las nuevas características del
SQLServer 2005 con los objetos System.Data y System.Xml. Por eso, ADO.NET 2.0 sólo
incluye algunos objetos y características nuevas y actualizadas que son compatibles con
las fuentes de datos de SQLServer 2000. Más adelante, en este mismo libro, se tratarán
las propiedades de ADO.NET 2.0 y VB.NET 2005 específicas para SQLServer 2005.
A continuación indicamos los objetos en tiempo de ejecución y actualizados, métodos
y características de lenguaje, más importantes para los proyectos de formulario
Windows:
37
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 38
Bases de datos con Visual Basic
)
)
)
)
)
)
)
El objeto DbProviderFactory permite escribir código común para proveedores de
datos y servidores de bases de datos alternativos.
El objeto SqlBulkCopy permite insertar con gran eficiencia datos de SQLServer de
fuentes relacionales y XML.
El método SqlConnection.RetrieveStatistics proporciona información detallada sobre
la conexión abierta con el SQLServer.
La ejecución asincrónica de SqlCommand permite entrelazar consultas o actualizaciones múltiples de larga ejecución.
Los nuevos objetos actualizados DataTable soportan las características comunes de
los DataSet, como son los métodos ReadXml y WriteXml, retornan valores de los servicios Web e interfaces remotas y streaming.
A las tablas de datos se les puede asignar espacios-nombre y prefijos para los nombre de espacio.
Los tipos Null permiten definir objetos fuertemente tipificados, con miembros a los
que se puede asignar el valor DbNull.
En las secciones siguientes se explica cómo utilizar las características del precedente
ADO.NET 2.0 con ejemplos de código derivado de los proyectos-ejemplo de formularios Windows.
2.1.1 Utilizar DbProviderFactories para crear proyectos
con bases de datos agnósticas
La nueva clase System.Data.Common.DbProviderFactories proporciona a los desarrolladores de bases de datos la oportunidad de enfrentarse a la creación de aplicaciones
agnósticas frente a las fuentes de datos. Crear aplicaciones de entradas de datos no-triviales que puedan interactuar sin fisuras con todos los administradores de bases de
datos relacionales, para los que existen proveedores de datos controlados, no es precisamente algo simple. Las diferencias menores en la sintaxis SQL, tipos de datos, dialectos de procedimientos almacenados, tratamiento de error, y otras características propias de una base de datos, requerirán sin duda un esfuerzo. Si actualmente utiliza el
proveedor de datos controlados .NET Framework OleDb, o ADODB con proveedores
OLE DB para asegurar la interoperabilidad de las bases de datos, seguramente encontrará que Microsoft y el tercero en cuestión, ADO.NET, ofrecen mejor rendimiento y,
como resultado, mayor escalabilidad. Por otra parte, el nivel de ampliación y mejora
que .NET garantiza a los proveedores de datos, hace difícil escribir código que sea totalmente transparente al proveedor.
Los grupos de terceros de proveedores controlados .NET pueden reducir la interoperabilidad con
costes de licencia añadidos. Por ejemplo, DataDirect Technologies ofrece proveedores de datos
controlados para IBM DB2 y DB2 UDB; Oracle 8i, 9i, y 10g; SQLServer 7 y 2000; Sybase
Adaptive Server 11.5 y 11.9; y Sybase Adaptive Server Enterprise 12.0 y 12.5. Todos los proveedores DataDirect buscan salidas para minimizar las diferencias de sintaxis SQL y comunicarse con servidores a través de los protocolos de los vendedores de bases de datos.
38
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 39
Las novedades de ADO.NET 2.0
Crear un objeto DataReader de la clase DbProviderFactories es un proceso en siete pasos:
1. Crear un objeto DbProviderFactory pasando el nombre completo de la clase del proveedor de datos, como System.Data.SqlClient, al argumento de una sentencia
DimFactoryNameAsDbProviderFactory = DbProviderFactories.GetFactory(strProvider).
2. Crear un objeto IdbConnection invocando el método DimConnectionNameAsIDbConnection = FactoryName.CreateConnection().
3. Definir el valor de la propiedad ConnectionName.Connection.String.
4. Crear un objeto IdbCommand invocando el método DimCommandNameAsIDbCommand = ConnectionName.CreateCommand().
5. Definir para las propiedades CommandName.CommandType (opcional) y CommandName.CommandText los valores adecuados para el proveedor.
6. Llamar al método ConnectionName.Open().
7. Crear un objeto IdataReader invocando el método DimReaderNameAsIDataReader =
CommandName.ExecuteReader.
El objeto IDataReader tiene los miembros que los DataReaders específicos del proveedor
para ADO.NET 1.x y 2.0, más el nuevo método GetSchemaTable que se describe en el siguiente apartado.
El proyecto de ejemplo DbFactoryTest.sln muestra datos en pantalla de una de las tres
tablas Northwind creando y atravesando los objetos IDataReader de SqlClient, OleDb, u
Odbc, que se especifiquen seleccionando la opción apropiada. El formulario incluye
también un control DataGridView con el que se muestra en pantalla el esquema de tabla
DataTable (del que trata el siguiente apartado) tal como muestra la siguiente figura.
El siguiente listado contiene el código para las declaraciones de variables y el botón de
opción del manejador de eventos de OleDb DbProviderFactory:
39
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 40
Bases de datos con Visual Basic
'OleDb provider settings - Products table
Private strOleDbProvider As String = "System.Data.OleDb"
Private strOleDbConn As String = "Provider=SQLOLEDB;Data Source=.\SQLEXPRESS;" + _
"Initial Catalog=Northwind;Integrated Security=SSPI"
Private strOleDbTable As String = "Products"
Private Sub optOleDb_CheckedChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles optOleDb.CheckedChanged
If optOleDb.Checked = True Then
PopulateList(strOleDbProvider, strOleDbConn, strOleDbTable)
Me.Text = "DbFactory Test Form - OleDb"
End If
End Sub
El tratador de eventos optOleDB_CheckedChanged pasa los valores requeridos del
parámetro OleDb al procedimiento PopulateList, ampliado con el código siguiente:
Private Sub PopulateList(ByVal strProvider As String, _
ByVal strConn As String, ByVal strTable As String)
Dim cnFactory As IDbConnection = Nothing
Dim drData As IDataReader = Nothing
Try
Dim dpFactory As DbProviderFactory = _
DbProviderFactories.GetFactory(strProvider)
cnFactory = dpFactory.CreateConnection()
cnFactory.ConnectionString = strConn
Dim cmFactory As IDbCommand = cnFactory.CreateCommand
cmFactory.CommandType = CommandType.Text
cmFactory.CommandText = "SELECT * FROM " + strTable
cnFactory.Open()
drData = cmFactory.ExecuteReader(CommandBehavior.KeyInfo)
lstData.Items.Clear()
Dim dtSchema As DataTable
With drData
While drData.Read
lstData.Items.Add(.GetValue(0).ToString + _
" - " + .GetValue(1).ToString)
End While
dtSchema = drData.GetSchemaTable()
With dgvSchema
If dtSchema.Columns.Count > 1 Then
.RowHeadersVisible = False
.DataSource = dtSchema
.AutoGenerateColumns = True
Application.DoEvents()
If .Columns.Count > 0 Then
.Columns(0).Frozen = True
.Columns("BaseSchemaName").Width = 110
If .Columns.Count = 24 Then
.Columns(23).Width = 200
End If
End If
40
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 41
Las novedades de ADO.NET 2.0
End If
End With
End With
If dgvSchema.Columns.Count > 0 Then
Dim intCtr As Integer
Dim strDataCols As String = ""
For intCtr = 0 To dgvSchema.Rows(0).Cells.Count - 1
strDataCols += dgvSchema.Columns(intCtr).Name + vbTab + _
dgvSchema.Rows(0).Cells(intCtr).Value.ToString + vbCrLf
Next intCtr
intCtr = 0
End If
Catch exc As Exception
MsgBox(exc.Message + exc.StackTrace)
Finally
If Not drData Is Nothing Then
drData.Close()
End If
If Not cnFactory Is Nothing Then
cnFactory.Close()
End If
End Try
End Sub
Hay que especificar CommandBehavior.KeyInfo como el argumento ExecuteReader para devolver las claves primarias correctas y las propiedades de campo relacionadas.
Si sus proyectos deben incluir independencia respecto al proveedor de datos y está dispuesto a escribir más para especificar las diferencias, sutiles o no, entre las diferentes
mejoras de los proveedores de datos, pruebe con DbProviderFactories. Sin embargo,
tenga en cuenta que el código independiente de proveedores tiene que usar tipos de
datos originales .NET, antes que los tipos de datos específicos de cada proveedor para
los diferentes add-in de SQLServer, Oracle, y otros servidores soportados por terceros.
DbProviderFactories mejora la vinculación de la base de datos, lo que deja en clara desventaja a muchas propiedades del modelo de programación de ADO.NET. El SQL específico de un
vendedor y la sintaxis de ejecución de los procedimientos almacenados hacen que escribir
código transparente al vendedor con los proveedores de datos ADO.NET 2.0 sea difícil, si no
imposible.
2.1.2 Restablecer los esquemas de las tablas base
Los DataReaders de ADO.NET 1.x y 2.0 y los DataTableReaders de ADO.NET 2.0, tienen
un método GetSchemaTable que devuelve los correspondientes esquemas del objeto en
un objeto DataTable. Para dar información sobre el tipo de datos utilizado en los proyectos, que substituye el código para los controles de vinculación que muestran y actuali41
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 42
Bases de datos con Visual Basic
zan las tablas base, se utilizan los valores de propiedad del esquema DataTable. Los
esquemas DataTable dan valores ColumnLength para definir la propiedad MaxLength en
cuadros de texto y valores IsReadOnly que se pueden aplicar a la propiedad ReadOnly
de los controles de entrada de datos normal. Estos DataTable también devuelven información clave primaria como son los índices de columna y detalles de autoincrementación.
El System.Data.ObjectSpaces.ObjectDataReader, que se incluía en las primeras versiones alpha
y Community Technical Preview de VS 2005, daban miembros similares a los de otros
DataReaders, incluido el método GetSchemaTable. En Mayo del 2004, Microsoft anunció que
ObjectSpaces se lanzaría como componente dentro de las mejoras del sistema de archivos
WinFS.
Para crear un esquema DataTable en un DataReader y poblar una DataGridView para
mostrar las propiedades de columna se ha de utilizar código parecido al siguiente:
Dim dtSchema As DataTable
With drData
While drData.Read
lstData.Items.Add(.GetValue(0).ToString + _
" - " + .GetValue(1).ToString)
End While
dtSchema = drData.GetSchemaTable()
With dgvSchema
If dtSchema.Columns.Count > 1 Then
.RowHeadersVisible = False
.DataSource = dtSchema
.AutoGenerateColumns = True
Application.DoEvents()
If .Columns.Count > 0 Then
.Columns(0).Frozen = True
.Columns("BaseSchemaName").Width = 110
If .Columns.Count = 24 Then
.Columns(23).Width = 200
End If
End If
End If
End With
End With
El esquema DataTable contiene una fila por cada columna de tabla base y 27 campos de
propiedades de columna SqlDataReader. OleDbDataReaders y OdbcDataReaders devuelven 18 propiedades; los DataTableReaders tienen 25 campos de propiedades. Como el
objeto DataTableReader es nuevo en ADO.NET 2.0, en la tabla siguiente se comparan el
índice de campos del esquema DataTable y los nombres de propiedades de las tres clases de DataReaders.
42
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 43
Las novedades de ADO.NET 2.0
Index
SqlDataReader
OleDb y Odbc
DataReaders
DataTableReader
0
ColumnName
ColumnName
ColumnName
1
ColumnOrdinal
ColumnOrdinal
ColumnOrdinal
2
ColumnSize
ColumnSize
ColumnSize
3
NumericPrecision
NumericPrecision
NumericPrecision
4
NumericScale
NumericScale
NumericScale
5
IsUnique
DataType
DataType
6
IsKey
ProviderType
ProviderType
7
BaseServerName
IsLong
IsLong
8
BaseCatalogName
AllowDBNull
AllowDBNull
9
BaseColumnName
IsReadOnly
IsReadOnly
10
BaseSchemaName
IsRowVersion
IsRowVersion
11
BaseTableName
IsUnique
IsUnique
12
DataType
IsKey
IsKey
13
AllowDBNull
IsAutoIncrement
IsAutoIncrement
14
ProviderType
BaseSchemaName
BaseCatalogName
15
IsAliased
BaseCatalogName
BaseSchemaName
16
IsExpression
BaseTableName
BaseTableName
17
IsIdentity
BaseColumnName
BaseColumnName
18
IsAutoIncrement
AutoIncrementSeed
19
IsRowVersion
AutoIncrementStep
20
IsHidden
DefaultValue
21
IsLong
Expression
22
IsReadOnly
ColumnMapping
23
ProviderSpecificDataType
BaseTableNamespace
24
DataTypeName
BaseColumnNamespace
25
XmlSchema Collection
Database
26
XmlSchema Collection
OwningSchema
27
XmlSchema CollectionName
Las propiedades que se muestran en negrita son miembros de la nueva clase de ADO.NET 2.0
System.Data.Common .SchemaTableColumn y son necesarias. El resto son miembros opcionales de la clase SystemData.Common.SchemaOptionalTableColumn. Los campos XmlSchemaCollection aparecen sólo en las tablas del SQLServer 2005 y especifican el esquema, si existe, de
los campos para los tipos de datos xml.
Los desarrolladores de bases de datos pueden traducir la mayor parte de las propiedades incluidas en la tabla-lista anterior. Por eso la tabla siguiente sólo ofrece la lista de
las propiedades cuyo significado no es obvio o que devuelven valores inesperados.
43
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 44
Bases de datos con Visual Basic
Nombre de la propiedad
Descripción
ColumnSize
Devuelve –1 si el dato no está disponible, de lo contrario, el
tamaño de la columna en bytes.
DataType
El tipo de datos original de .NET que corresponde al tipo de dato
de la columna, como en System.Int32 o System.String.
ProviderType
El valor íntegro de una enumeración de tipo de datos especifícos
del proveedor.
IsLong
True indica un tipo de datos text o ntext de SQL, o un image,y
un campo de objeto OLE o Jet Memo.
ProviderSpecificDataType
Uno de los tipos Sql, como SqlString o SqlInt32 (sólo SqlClient)
Expression
La expresión calculada para una columna de una DataTable (sólo
DataTable)
ColumnMapping
Un valor String que especifica la columna de la tabla de destino o
1 si la columna no está mapeada (sólo DataTable)
BaseTableNamespace
El nombre de espacio XML asignado a la tabla, heredado del
nombre de espacio del DataSet si está vacío (sólo DataTable)
BaseColumnNamespace
El nombre de espacio XML asignado a la tabla, heredado del
nombre de espacio del DataSet si está vacío (sólo DataTable)
XmlSchema Collection
Database
El nombre de la base de datos del servidor SQL Server 2005 que
contiene el conjunto de esquemas para una columna del tipo
xml (null si la columna xml no tiene esquema)
XmlSchema CollectionOwning
Schema
Esquema relacional del SQL Server 2005 que contiene el conjunto de XmlSchema (null si la columna xml no tiene esquema)
XmlSchema CollectionName
Nombre del conjunto de esquemas para una columna del tipo
xml (null si la columna xml no tiene esquema)
Más adelante en este capítulo, se describe cómo cargar y persistir DataTables desde
bases de datos y archivos XML, y mostrar en pantalla la información del esquema de
los objetos DataTable.
2.2 Comprobar las instancias de servidor SQL
disponibles y los proveedores de datos
ADO.NET 2.0
El método System.Data.Common.SqlDataSourceEnumerator.Instance.GetDataSources devuelve una DataTable que tiene una fila para cada instancia de servidor SQL 2000 y 2005
accesibles. Las columnas muestran las propiedades ServerName, InstanceName,
IsClustered, y Version.
Al invocar el método DbProviderFactories.GetFactoryClasses(), éste devuelve una tabla
similar con una fila para cada proveedor Microsoft de datos controlados .NET instala-
44
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 45
Las novedades de ADO.NET 2.0
dos en el sistema, con columnas para las propiedades del proveedor Name, Description,
InvariantName, y AssemblyQualifiedName y el número de SupportedClasses. Los proveedores de datos a terceros, como Oracle ODP.NET con Oracle 10g (Oracle.DataAccess.dll),
no aparecen en la tabla.
El archivo machine.config contiene un elemento para cada uno de los cuatro espacios de nombre de proveedores de datos ADO.NET 2.0, y una sección system.data que añade estos proveedores a DbProviderFactories. El método GetFactoryClasses lee el archivo machine.config para
proporcionar la lista de proveedores instalados.
El siguiente código, del proyecto de ejemplo DataEnums.sln, puebla dos controles DataGridView con una instancia de SQLServer y un proveedor instalado de datos .NET de
Microsoft:
Private Sub frmDataEnums_Load(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles MyBase.Load
Dim dtServers As DataTable = SqlDataSourceEnumerator.Instance.GetDataSources
With dgvServers
.DataSource = dtServers
.AutoGenerateColumns = True
.RowHeadersVisible = False
.BorderStyle = BorderStyle.None
End With
Dim dtProviders As DataTable = DbProviderFactories.GetFactoryClasses()
With dgvProviders
.DataSource = dtProviders
.AutoGenerateColumns = True
.RowHeadersVisible = False
.RowTemplate.Height = 22
.BorderStyle = BorderStyle.None
End With
End Sub
Al ejecutar el proyecto DataEnums, éste enumera las instancias de SQLServer y los proveedores de datos instalados. La Figura siguiente muestra una instancia por defecto de un
SQLServer 2000 (OAKLEAF-W2K3), y una instancia MSDE con nombre (OAKLEAFW2K3\SHAREPOINT), una instancia de SQLServer 2005 (OAKLEAF-MS18), y una instancia SQLExpress (SQLX) con nombre (OAKLEAF-MS18\SQLEXPRESS), así como proveedores de datos accesibles o instalados en el ordenador de desarrollo utilizado para
escribir este libro.
45
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 46
Bases de datos con Visual Basic
2.2.1 Entradas Batch en tablas de servidor SQL con el
objeto SqlBulkCopy
La utilidad BCP del SQLServer y la sentencia BULK INSERT son los métodos tradicionales para añadir filas muy rápidamente a las tablas del SQL Server. ADO.NET 2.0 ofrece una opción alternativa: programar el nuevo objeto SqlBulkCopy. La fuente más habitual para las filas son los DataReader en tablas relacionales. Otra alternativa es insertar
filas desde documentos tabulares XML creando un juego de datos en tiempo de ejecución runtime con una o más tablas de datos para copiar.
Copiar documentos XML a las tablas del servidor SQL (un proceso llamado shredding) es
mucho más sencillo con SqlBulkCopy que con la propiedad para cargar de SQLXML3.0. Cargar
requiere un esquema XML anotado para mapear elementos o atributos y añadirlos a las columnas de las tablas base. SqlBulkCopy tiene una colección de ColumnMappings que permite definir la relación entre las columnas de la tabla de datos fuente y las de la tabla base destino.
Para insertar filas de un DataReader en una tabla base destino ya existente, hay que:
1. Crear una conexión y un comando para los datos fuente. Se puede usar cualquier
proveedor .NET para conectarse a la fuente de datos y crear el DataReader.
2. Aplicar el método Command.ExecuteReader para crear el DataReader.
3. Crear un objeto nuevo SqlBulkCopy que tendrá como argumentos el string de conexión y la enumeración apropiada en SqlBulkCopyOptions.
4. Definir el valor de la propiedad SqlBulkCopy.DestinationTableName.
5. Añadir miembros ColumnMapping a la colección ColumnMappings si el esquema de
la tabla destino difiere de la tabla o la petición fuente.
6. Definir otros valores opcionales para la propiedad SqlBulkCopy, como BatchSize y
BulkCopyTimeout.
46
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 47
Las novedades de ADO.NET 2.0
7. Si la operación de copia implica un número muy alto de registros o ejecuciones con
una conexión de red muy lenta, añadir un tratador para el evento SqlBulkCopy.SqlRowsCopied a fin de mostrar en pantalla el número o el porcentaje de registros
copiados.
8. Invocar el método SqlBulkCopy.WriteToServer para ejecutar la operación de copia.
9. Aplicar el método SqlBulkCopy.Close() y, si ya ha terminado, cierre la conexión. En
caso contrario, use de nuevo el objeto SqlBulkCopy para realizar cualquier otra operación.
La tabla siguiente describe los miembros de la enumeración SqlBulkCopyOptions.
Nombre del miembro Descripción
CheckConstraints
Aplica un chequeo restringido durante el proceso de copia.
Default
No utiliza opciones (por defecto) para la operación de copiar.
FireTriggers
Permite a detonadores INSERT dispararse durante el proceso de copia.
KeepIdentity
Utiliza valores de identificación de la tabla fuente en lugar de generar
nuevos valores de identidad basados en los valores de integridad e
incremento de la tabla destino.
KeepNulls
Conserva los valores null de la tabla fuente a pesar de los valores por
defecto de las tablas destino.
TableLock
Aplica un candado a toda la tabla durante el proceso de copia, en
lugar del candado por defeccto aplicado por filas.
UseInternalTransaction
Hace que cada batch de la copia bulk se ejecute dentro de una transacción.
KeepIdentity es el miembro más importante de la enumeración SqlBulkCopyOptions para tablas
que usan una columna de identificación como clave primaria. Si no se especifica esta opción, las
claves de la tabla destino podrían ser distintas de los valores en la tabla fuente. También es conveniente añadir la opción UseInternalTransaction para prevenir copias parciales si ocurriera
alguna excepción durante el proceso.
El ejemplo más sencillo de una operación SqlBulkCopy crea copias de tablas en la misma
base de datos. El siguiente código del proyecto BulkCopySameSchema.sln copia las tablas
de productos Northwind (Northwind Products) como ProductsCopy:
Private Sub btnCopyProds_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles btnCopyProds.Click
Dim sdrProds As SqlDataReader = Nothing
Dim sbcProds As SqlBulkCopy = Nothing
Try
Dim lngTime As Long = Now.Ticks
btnCopyProds.Enabled = False
cnnNwind.Open()
cmdProds.CommandText = "DELETE FROM ProductsCopy"
Dim intRecs As Integer = cmdProds.ExecuteNonQuery
47
VisualBasic2005_02.qxp
02/08/2007
16:14
PÆgina 48
Bases de datos con Visual Basic
cmdProds.CommandText = "SELECT * FROM Products"
sdrProds = cmdProds.ExecuteReader()
If chkKeepIdentity.Checked Then
sbcProds = New SqlBulkCopy(strConn, _
SqlBulkCopyOptions.UseInternalTransaction Or _
SqlBulkCopyOptions.KeepIdentity)
Else
sbcProds = New SqlBulkCopy(strConn, _
SqlBulkCopyOptions.UseInternalTransaction)
Dim blnUseCm As Boolean = True
If blnUseCm Then
sbcProds.ColumnMappings.Clear()
Dim intCol As Integer
For intCol = 1 To 9
sbcProds.ColumnMappings.Add(intCol, intCol)
Next intCol
End If
End If
AddHandler sbcProds.SqlRowsCopied, New
SqlRowsCopiedEventHandler(AddressOf ProdRowAdded)
With sbcProds
.DestinationTableName = "ProductsCopy"
.BatchSize = CInt(nudBatchSize.Value)
.BulkCopyTimeout = 30
.NotifyAfter = 1
.WriteToServer(sdrProds)
.Close()
End With
sdrProds.Close()
lngTime = Now.Ticks - lngTime
txtTime.Text = Format(lngTime / 10000000, "0.000")
FillProdsList(True)
Catch excCopy As Exception
MsgBox(excCopy.Message + excCopy.StackTrace, , "Products Bulk Copy
Exception")
Finally
If Not sbcProds Is Nothing Then
sbcProds.Close()
End If
If Not sdrProds Is Nothing Then
sdrProds.Close()
End If
If Not cnnNwind Is Nothing Then
cnnNwind.Close()
End If
btnCopyProds.Enabled = True
End Try
End Sub
48
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 49
Las novedades de ADO.NET 2.0
La propiedad SqlBulkCopy.NotifyAfter determina el número de filas añadidas antes de
dispararse el evento SqlRowsCopied. A continuación vemos el código para un tratador
de eventos SqlRowsCopied que muestra el progreso del proceso de copia de las tablas de
productos en un cuadro de texto:
Sub ProdRowAdded(ByVal oSource As Object, ByVal oArgs As SqlRowsCopiedEventArgs)
txtProdRows.Text = oArgs.RowsCopied.ToString
Application.DoEvents()
End Sub
Mostrar el progreso de la copia reduce sustancialmente la velocidad de la copia. En las aplicaciones finales que deben proporcionar interacción al usuario, el valor de la propiedad
NotifyAfter debe ser como mínimo el 10 por ciento del número total de registros añadidos.
La siguiente figura muestra el formulario del proyecto BulkCopySameSchema.sln después de copiar las dos tablas. Los scripts Transact-SQL recrean la tabla en el manejador
de eventos frmBulkCopy_Load. Los cuadros de lista muestran la clave primera de la
tabla fuente y los valores de segunda columna cuando se carga el formulario, y los
valores de la tabla destino después de la copia. El deslizador Batch Size determina el
número de filas por intervalo; 0 (el valor por defecto) intenta enviar todas las filas al
servidor en un solo intervalo. Definiendo 1 para el tamaño del intervalo y copiando de
nuevo las tablas se puede comparar el rendimiento de la copia frente a las operaciones
fila por fila.
Cachear datos y código provoca una diferencia considerable entre el tiempo de ejecución de la
copia bulk inicial y las siguientes. Por lo tanto, habría que comparar los tiempos de ejecución
con batchs de diferentes tamaños después de una o dos pruebas con un tamaño de batch definido en 0.
Deseleccionando el cuadro de verificación Keep Source Identity, la opción KeepIdentity se
elimina del constructor SqlBulkCopy de la tabla de productos. En este caso, los valores
de clave primarios se incrementan en 77 por cada operación de copia. En el apartado
49
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 50
Bases de datos con Visual Basic
siguiente se describe el tratador de eventos para el botón Show Connection Statistics
(Mostrar estadísticas de conexión).
2.2.2 Obtener las estadísticas de conexión del servidor
SQL
El nuevo método SqlConnection.RetrieveStatistics averigua la instancia del servidor SQL
con los datos de la conexión actual y devuelve un objeto IDictionary que contiene los 18
pares nombre/valor que muestra la siguiente figura.
Esta propiedad se ha de permitir explícitamente ejecutando una instrucción SqlConnection.EnableStatistics=True antes de invocar el método RetrieveStatistic. El método más
sencillo para para tratar los valores nombre/valor es encrustar el objeto IDictionary en
un tipo HashTable y, después reiterar la tabla Hash en un bucle ForEach...Next. El código siguiente del proyecto BulkCopySameSchema.sln muestra en pantalla las estadísticas
en un cuadro de texto de un sencillo formulario frmConnStats:
Private Sub btnShowStats_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnShowStats.Click
Try
htStats = CType(cnnNwind.RetrieveStatistics(), Hashtable)
Dim txtStats As Control = frmConnStats.Controls.Item("txtStats")
txtStats.Text = ""
Dim oStat As Object
Dim strStat As String
For Each oStat In htStats.Keys
strStat = oStat.ToString
If InStr(strStat, "Time") > 0 Then
txtStats.Text += strStat + " = " + _
50
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 51
Las novedades de ADO.NET 2.0
Microsoft.VisualBasic.Format(CLng(htStats(strStat)) /1000, _
"#,##0.000") + " secs" + vbCrLf
Else
txtStats.Text += strStat + " = " + htStats(strStat).ToString
+ vbCrLf
End If
Next
frmConnStats.Show()
frmConnStats.Controls.Item("btnClose").Focus()
Catch excStats As Exception
MsgBox(excStats.Message + excStats.StackTrace, , _
"Exception Displaying Connection Statistics")
End Try
End Sub
El código anterior y el formulario frmConnStats se pueden añadir a cualquier proyecto
que utilice una SqlConnection. Invoque el método SqlConnection.ResetStatistics para inicializar los datos, excepto ConnectionTime.
Recuperar las estadísticas de conexión requiere establecer de nuevo una conexión con el servidor, por lo tanto es mejor reservar el uso de esta función para diagnosticar problemas de
conexión.
2.3 Ejecutar comandos SQL de forma asincrónica
ADO.NET 2.0 añade los métodos BeginExecuteReader, BeginExecuteXmlReader, y BeginExecuteNonQuery (junto con los correspondientes métodos End) para las clases SqlCommand. Estos métodos permiten ejecutar código mientras se espera a que un comando complete su ejecución. Para ejecutar un comando SqlCommand hay que añadir
Async=True a la cadena de comando que se pasó al constructor de la SqlConnection. En
los apartados siguientes se describe, con el correspondiente código de ejemplo, para los
tres modelos de ejecución de comandos SqlCommand asíncronos que soporta la interfaz
IasyncResul. La siguiente figura ilustra las bases de datos, conexiones y comandos que
se utilizan con los tres modelos. Obtendrá resultados más interesantes del proyecto de
ejemplo AsyncDataOperations.sln si dispone de dos o tres instancias del servidor SQL
Server 2000 o 2005 con la base de datos de ejemplo de Northwind para cada instancia
(figura en la página siguiente).
El proveedor de memoria compartida por defecto del SQLServer 2000 no soporta comando asícronos, por lo que hay que utilizar localhost, y no (local), como valor para el servidor o la fuente de datos de la cadena de conexión en cualquier instancia local del SQLServer 2000.
51
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 52
Bases de datos con Visual Basic
2.3.1 El modelo Polling
El modelo Polling es el más sencillo de los tres. La siguiente figura ilustra el flujo del
programa para tres conexiones asíncronas (figura en la página siguiente).
El código siguiente abre un comando asíncrono en la base de datos Northwind, en una
instancia del servidor local SQL y utiliza un bucle While que consulta constantemente
para que se complete el método BeginExecuteReader:
Private Sub PollingAsyncCommand()
Try
Dim strConn As String = "Data Source=localhost;" + _
"Initial Catalog=Northwind;Integrated Security=SSPI;Async=True"
Dim cnnCusts As SqlConnection = New SqlConnection(strConn)
cnnCusts = New SqlConnection(strCusts)
Dim cmdCusts As SqlCommand = cnnCusts.CreateCommand
With cmdCusts
.CommandType = CommandType.Text
.CommandTimeout = 60
.CommandText = "SELECT * FROM Customers"
End With
Dim asrCustsReader As IAsyncResult = _
cmdCusts.BeginExecuteReader(CommandBehavior.CloseConnection)
While Not asrCustsReader.IsCompleted
'Do something while waiting
52
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 53
Las novedades de ADO.NET 2.0
End While
Dim sdrCusts As SqlDataReader = cmdCusts.EndExecuteReader(asrCustsReader)
'Do something with the data
sdrCusts.Close()
sdrCusts.Dispose()
Catch excAsync As Exception
MsgBox(excAsync.Message + excAsync.StackTrace, , "Async Operation
Exception")
End Try
End Sub
La ejecución asíncrona con polling es muy práctica para las operaciones sencillas dentro del bucle While, como mostrar una barra de progresión cuyo valor vienen definido
por las pulsaciones e un contador. También se puede incluir código que permita al
usuario cancelar un comando antes del tiempo indicado por su propiedad CommandTimeout. Al salir del bucle, la ejecución del mismo queda bloqueada hasta que se
hayan completado todos los comandos o haya expirado su tiempo de ejecuión. El código se va ejecutando en el hilo del formulario, por lo que los comandos múltiples se eje53
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 54
Bases de datos con Visual Basic
cutan secuencialmente en conexiones separadas. Si las operaciones múltiples DataReader.Read son complejas, se pueden ejecutar en un hilo dedicado al nuevo objeto
BackgroundWorker. Esto permite invocar el siguiente método BeginExecuteReader inmediatamente después de que la propiead IAsyncResult.IsComplete cambie a True.
2.3.2 El módelo Callback
El módelo asíncrono callback es más flexible que el polling porque utiliza un manejador
de callback que ejecuta su propio hilo, extraído de la consulta. El modelo callback permite entrelazar comandos con bases de datos múltiples que se ejecutan en lo mismos servidores o en servidores distintos. En ese caso, hay que especificar el tratador callback y
pasarle el comando como objeto al segundo parámetro del método sobrecargado BeginExecuteReader. Al pasar el comando se tiene acceso al método EndExecuteReader con
la propiedad IAsyncResult.AsyncState en el tratador callback. La siguiente figura muestra el flujo del programa en el modo callback. Las líneas punteadas indican la ejecución
directa de los métodos Read, sin tener que esperar a que estén disponibles dotos los juegos de filas.
54
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 55
Las novedades de ADO.NET 2.0
A continuación mostramos un ejemplo de código para un comando asíncrono sencillo
SqlCommand que usa el método callback:
Private Sub CallbackAsyncCommand()
Try
Dim strConn As String = "Data Source=localhost;" + _
"Initial Catalog=Northwind;Integrated Security=SSPI;Async=True"
Dim cnnCusts As SqlConnection = New SqlConnection(strConn)
cnnCusts = New SqlConnection(strCusts)
Dim cmdCusts As SqlCommand = cnnCusts.CreateCommand
With cmdCusts
.CommandType = CommandType.Text
.CommandTimeout = 60
.CommandText = "SELECT * FROM Customers"
End With
cnnCusts.Open()
Dim objCmdCusts As Object = CType(cmdCusts, Object)
Dim asrCustsReader As IAsyncResult = _
cmdCusts.BeginExecuteReader(New AsyncCallback(AddressOf
CustomersHandler), _
objCmdCusts, CommandBehavior.CloseConnection)
Catch excAsync As Exception
MsgBox(excAsync.Message + excAsync.StackTrace, , "Async Operation
Exception")
End Try
End Sub
Y aquí está el código del tratador callback para el procedimiento anterior:
Private Sub CustomersHandler(ByVal iarResult As IAsyncResult)
Try
Dim sdrData As SqlDataReader = CType(iarResult.AsyncState,
SqlCommand).EndExecuteReader(iarResult)
With sdrData
Dim intCtr As Integer
While .Read
For intCtr = 0 To .FieldCount - 1
objData = .GetValue(intCtr)
Next intCtr
End While
.Close()
.Dispose()
End With
Dim blnIsPool As Boolean = Thread.CurrentThread.IsThreadPoolThread
CustomersDone(Thread.CurrentThread.ManagedThreadId, blnIsPool)
Catch excHandler As Exception
MsgBox(excHandler.Message + excHandler.StackTrace, , "Customers
Handler Exception")
End Try
End Sub
55
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 56
Bases de datos con Visual Basic
La mayor parte de los ejemplos de cliente de este libro conectan con finales back en la misma
máquina que el cliente; eso significa que la ejecución sincrónica de los DataReaders se completa rápidamente o bien arroja inmediatamente una excepción. La ejecución asincrónica resulta
especialmente eficaz en los proyectos con DataReaders múltiples que conectan individualemente a bases de datos remotas, especialmente si una o más conexiónes se ejecutan en un WAN.
El proyecto de ejemplo AsyncDataOperations.sln simula una aplicación de producción
que conecta a bases de datos trabajadas en red múltiple estableciendo conexiones individuales SqlConnections con tablas Northwind de clientes, pedidos y detalles de pedidos
(Customers, Orders, y Order Details). Si tiene acceso a tres instancias de servidor SQL
puede modificar las cadenas de conexión cambiando los nombres del segundo y el tercer servidor (OAKLEAF-W2K3 y OAKLEAF-MS2K3) por RemoteServerName, y seleccionar el cuadro de texto Use Multiple Instances para mostrar la secuencia de invocaciones
de los métodos Connection.Open, BeginExecuteReader, y EndExecuteReader. La siguiente
figura muestra dos instancias del formulario AsyncDataOperations.
Una clase timer VB.NET, escrita por Alastair Dallas, proporciona la resolución requerida para
obtener datos de sincronización con sentido. Los números entre paréntesis de las entradas del
cuadro de lista son los valores System.Threading.Thread .CurrentThread.ManagedThreadId de
las instancias del formulario y los tres manejadores de callback El sufijo P indica que los hilos
del manejador son del pool de hilos. La sincronización de datos es para una segunda ejecución
(cacheada).
El código de ejemplo ejecuta objetos Customer desde el host local y objeto Orders y
Order Details desde los servidores de red. La tabla Orders Details tiene unas 500.000 filas,
por lo que leer toda la tabla lleva unos 2 segundos. La velocidad de ejecución en una
LAN de bajo tráfico es normalmente suficiente para devolver los datos en la secuencia
BeginExecuteReadercalling, como muestra la figura anterior (izquierda). Todas las operaciones de restablecimiento de datos se ejecutan en un solo hilo (13). Para simular una
conexión WAN con la tabla Orders, el código en OrdersHandler provoca un retraso de
unos segundos mediante múltiples operaciones en cada fila DataReader en un bucle ani56
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 57
Las novedades de ADO.NET 2.0
dado. En este caso, DataReader de Orders completa la ejecución antes que el DataReader
de Customers, el cual termina la ejecución antes que el DataReader de Order Details, tal
como muestra la figura anterior (derecha). En este caso, la restauración de Order Details
se ejecuta en un hilo (14P), y Customers y Orders en otro distinto (13P).
El uso del modelo callback en las aplicaciones de formulario Windows es un tema controvertido. Miembros del equipo de datos de VS 2005 de Microsoft recomiendan no utilizar este modelo con los proyectos de formulario de Windows. Los objetos de ADO.NET no son seguros en los
hilos, y los problemas con hilos son difíciles de depurar.
2.3.3 El modelo WaitAll
Una alternativa al método callback es utilizar un array WaitHandle y asignarlo a un elemento en cada llamada de método BeginExecuteReader. Un WaitHandle.WaitAll(whArray) detiene la ejecución del código hasta que todos los DataReaders están listos para
sus llamadas EndExecuteReader. Este comportamiento hace al modelo WaitAll especialmente adecuado para clientes que procesan juegos de filas relacionados, ya que no se
necesita el bucle de sincronización que se mostró anteriormente. La siguiente figura
muestra el diagrama de flujo en el modelo WaitAll.
57
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 58
Bases de datos con Visual Basic
La manera más sencilla de ver los resultados del método WaitAll en un entorno de formulario Windows es crear una versión multi-hilo o multi-threaded apartment (MTA) de un
procedimiento habitual Sub Main. Por defecto, los procedimientos de VB.NET utilizan el
modelo de hilo único (single-threaded apartment, STA) requerido para los formularios basados en Win32. Llamando WaitAll con múltiples WaitHandles, arroja una excepción dentro
de los procedimiento STA, por lo que hay que añadir el prefijo <MTAThreadAttribute()> a
la sentencia SharedSubMain. El siguiente listado es una adaptación del código del modelo callback para implementar el array multi-elemento WaitHandle:
<MTAThreadAttribute()> _
Shared Sub Main()
Dim blnIsMultiServer As Boolean
Try
cnnCusts = New SqlConnection(strCusts)
Dim cmdCusts As SqlCommand = cnnCusts.CreateCommand
With cmdCusts
.CommandType = CommandType.Text
.CommandTimeout = 10
.CommandText = "SELECT * FROM Customers"
End With
If blnIsMultiServer Then
cnnOrders = New SqlConnection(strOrders)
Else
cnnOrders = New SqlConnection(strCusts)
End If
Dim cmdOrders As SqlCommand = cnnOrders.CreateCommand
With cmdOrders
.CommandType = CommandType.Text
.CommandTimeout = 10
.CommandText = "SELECT * FROM Orders"
End With
If blnIsMultiServer Then
cnnDetails = New SqlConnection(strDetails)
Else
cnnDetails = New SqlConnection(strCusts)
End If
Dim cmdDetails As SqlCommand = cnnDetails.CreateCommand
With cmdDetails
.CommandType = CommandType.Text
.CommandTimeout = 10
.CommandText = "SELECT * FROM [Order Details]"
End With
Dim timHiRes As New clsTimer
timHiRes.Start()
58
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 59
Las novedades de ADO.NET 2.0
Dim awhHandle(2) As WaitHandle
cnnCusts.Open()
astrListItems(0) = Format(timHiRes.ElapsedTime, "0.000") + " - 1
Opened Customers connection"
Dim asrCustomersReader As IAsyncResult
asrCustomersReader =
cmdCusts.BeginExecuteReader(CommandBehavior.CloseConnection)
awhHandle(0) = asrCustomersReader.AsyncWaitHandle
astrListItems(1) = Format(timHiRes.ElapsedTime, "0.000") + " - 2
BeginExecuteReader: Customers"
cnnOrders.Open()
astrListItems(2) = Format(timHiRes.ElapsedTime, "0.000") + " - 3
Opened Orders connection"
Dim asrOrdersReader As IAsyncResult
asrOrdersReader =
cmdOrders.BeginExecuteReader(CommandBehavior.CloseConnection)
awhHandle(1) = asrOrdersReader.AsyncWaitHandle
astrListItems(3) = Format(timHiRes.ElapsedTime, "0.000") + " - 4
BeginExecuteReader: Orders"
cnnDetails.Open()
astrListItems(4) = Format(timHiRes.ElapsedTime, "0.000") + " - 5
Opened Details connection"
Dim asrDetailsReader As IAsyncResult
asrDetailsReader =
cmdDetails.BeginExecuteReader(CommandBehavior.CloseConnection)
awhHandle(2) = asrDetailsReader.AsyncWaitHandle
astrListItems(5) = Format(timHiRes.ElapsedTime, "0.000") + " - 6
BeginExecuteReader: Order Details"
WaitHandle.WaitAll(awhHandle)
Dim sdrCustomers As SqlDataReader =
cmdCusts.EndExecuteReader(asrCustomersReader)
sdrCustomers.Close()
sdrCustomers.Dispose()
Dim sdrOrders As SqlDataReader =
cmdOrders.EndExecuteReader(asrOrdersReader)
sdrOrders.Close()
sdrOrders.Dispose()
Dim sdrDetails As SqlDataReader =
cmdDetails.EndExecuteReader(asrDetailsReader)
sdrDetails.Close()
59
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 60
Bases de datos con Visual Basic
sdrDetails.Dispose()
astrListItems(6) = Format(timHiRes.ElapsedTime, "0.000") + " - 7
EndExecuteReader: All readers"
frmAsync.ShowDialog()
Catch excAsync As Exception
MsgBox(excAsync.Message + excAsync.StackTrace, , "Async Operation
Exception")
End Try
End Sub
El primer paso es crear un array WaitHandle con el mismo número de elementos que
comandos asíncronos. Al igual que con el modelo callback, se abren las conexiones, se
ejecutan las instrucciones SqlCommand.BeginExecuteReader, y se añaden los correspondientes objetos SqlDataReader.AsyncWaitHandle al array WaitHandle sin importar el orden. La ejecución se detiene al llegar a la instrucción WaitHandle.WaitAll(awhHandle)
hasta que se completan todos los DataReaders. Al retomarse la ejecución, los juegos de
filas se procesan en el orden deseado (en este caso padre, hijo, nieto).
El código Shared Sub Main del proyecto de ejemplo AsyncDataOperations.sln se puede
ejecutar abriendo la ventana de propiedades del proyecto, seleccionando la página de
Aplicación, marcando el cuadro de verificación Habilitar marco de trabajo de la aplicación
y pulsando <Ctrl> + <S> para guardar los cambios. La siguiente figura muestra el formulario con el valor True para blnIsMultiServerflag.
2.3.4 Crear tablas de datos independientes
Las tablas de datos de ADO.NET 1.x son miembros, normalmente, de los objetos
DataSet. ADO.NET 2.0 permite crear tablas de datos ligeras, independientes, que comparten muchos métodos DataSet, como ReadXml, ReadXmlSchema, WriteXml, y WriteXmlSchema. Las tablas de datos también soportan interfaces DataReader con el método
Load(DataReader) y el objeto DataTableReader. También se puede asignar un prefijo nombre de espacio a la tabla de datos. Los apartados anteriores de este capítulo introducí60
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 61
Las novedades de ADO.NET 2.0
an las tablas de datos y los controles DataGridView poblados por los métodos GetSchemaTable, GetDataSources, y GetFactoryClasses.
El proyecto StandaloneDataTables.sln ilustra las siguientes características de las tablas de
datos:
)
)
)
)
)
Crear una DataTable con un SqlDataReader, ejecutar un DataTableReader, y vincular
la DataTable a una DataGridView editable.
Persistir el contenido de una DataTable en archivos XML sólo para datos y esquema, en formato DataSet, y con ediciones de DataTable en formato “diffGram”.
Definir los valores de Namespace y, opcionalmente, de la propiedad Prefix.
Utilizar el método ReadXml para cargar una tabla de datos desde el archivo guardado DataSet.xml
Mostrar en pantalla el esquema DataTable con el método DataTable.GetSchemaTable
La siguiente figura muestra el formulario del proyecto para la la tabla de datos independiente StandaloneDataTables.sln después de una mínima edición de la columna ContactName de la primera fila. Los botones Show... abren documentos XML guardados en
Internet Explorer. La parrilla inferior muestra el esquema DataTable del SqlDataReader o
bien, después de pulsar el botón Reload from XMLFiles, el esquema de la tabla de datos
primaria.
El procedimiento siguiente carga una base de datos del archivo Northwind Customers,
añade un nombre de espacio y un prefijo adicionales, designa la columna clave primaria (si falta), crea un esquema DataTable, itera la tabla de datos primaria con un
DataTableReader, y activa el procedimiento LoadDataGridView para mostrar en pantalla
61
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 62
Bases de datos con Visual Basic
los contenidos y el esquema de la tabla:
Private Sub LoadFromDatabase(ByVal blnWithNamespace As Boolean)
Dim strConn As String = "Server=.\SQLEXPRESS;Integrated
Security=True;Database=Northwind"
Dim cnnNwind As SqlConnection = New SqlConnection(strConn)
Try
Dim cmdCusts As SqlCommand = cnnNwind.CreateCommand
With cmdCusts
.CommandType = CommandType.Text
.CommandText = "SELECT * FROM Customers"
End With
cnnNwind.Open()
Dim drCusts As SqlDataReader =
cmdCusts.ExecuteReader(CommandBehavior.KeyInfo)
dtCusts = New DataTable
dtSchema = drCusts.GetSchemaTable
With dtCusts
.TableName = "Customers"
If blnWithNamespace Then
'.Prefix = "custs"
.Namespace = "http://www.oakleaf.ws/schemas/northwind/custo
mers"
End If
.Load(drCusts)
.AcceptChanges()
If .PrimaryKey.Length = 0 Then
Dim acolKeys(1) As DataColumn
acolKeys(0) = .Columns(0)
.PrimaryKey = acolKeys
End If
If Not .DataSet Is Nothing Then
Dim strName As String = .DataSet.DataSetName
MsgBox(strName)
End If
End With
drCusts.Close()
Dim dtrCusts As New DataTableReader(dtCusts)
intRows = 0
While dtrCusts.Read
intRows += 1
End While
dtrCusts.Close()
62
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 63
Las novedades de ADO.NET 2.0
LoadDataGridViews()
Catch excDT As Exception
MsgBox(excDT.Message + excDT.StackTrace, , "DataTable Load
Exception")
Finally
cnnNwind.Close()
End Try
End Sub
Eliminar el argumento CommandBehavior.KeyInfo del método ExecuteReader method para
añadir la clave primaria con código. Las instrucciones del test prueban que las tablas de datos
no generan juegos de datos de manera oculta.
Las tablas de datos que se cargan desde los DataReaders son actualizables, y se pueden
persistir como archivos de documentos XML en formatos DataSet sólo-datos, sóloesquema o diffGram. El procedimiento SaveXmlFiles genera documentos XML de datos
y esquema y mantiene el contenido de la tabla de datos en formato DataSet. El procedimiento guarda como archivo diffGram todas las ediciones que se hagan en
DataGridView.
Private Sub SaveXmlFiles(ByVal blnShowMessage As Boolean)
DeleteXmlFiles()
With dtCusts
.WriteXml(strPath + "Data.xml",
System.Data.XmlWriteMode.IgnoreSchema)
.WriteXml(strPath + "DataSet.xml",
System.Data.XmlWriteMode.WriteSchema)
.WriteXmlSchema(strPath + "Schema.xsd")
End With
btnShowData.Enabled = True
btnShowDataSet.Enabled = True
btnShowSchema.Enabled = True
Dim dtChanges As New DataTable
dtChanges = dtCusts.GetChanges
Dim strMsg As String
If dtChanges Is Nothing Then
strMsg = "Data and schema for " + intRows.ToString + " rows written
to '" _
+ strPath + "' folder."
btnShowDiffGram.Enabled = False
Else
dtChanges.WriteXml(strPath + "Diffgram.xml",
System.Data.XmlWriteMode.DiffGram)
strMsg = "Data for " + intRows.ToString + " rows, schema, and chan
ges diffgram written to '" + _
strPath + "' folder and changes accepted."
dtCusts.AcceptChanges()
btnShowDiffGram.Enabled = True
63
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 64
Bases de datos con Visual Basic
End If
If blnShowMessage Then
MsgBox(strMsg, , "XML Files Saved")
End If
btnReadXML.Enabled = True
End Sub
El manejador de eventos btnReadXML_Click carga la tabla de datos desde el archivo
guardado DataSet.xml, aplica las ediciones previas guardadas como archivo diffGram y
muestra en pantalla el esquema DataTable.
Si se añade un nombre de espacio a la tabla de datos cuando se importan valores de la tabla base,
se provocará un fallo en la validación del esquema al guardar el archivo de datos XML.
Private Sub btnReadXML_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles btnReadXML.Click
btnShowDiffGram.Enabled = False
Try
dtCusts = New DataTable
With dtCusts
.ReadXml(strPath + "DataSet.xml")
If File.Exists(strPath + "Diffgram.xml") Then
.ReadXml(strPath + "Diffgram.xml")
End If
.AcceptChanges()
End With
Dim dtrCusts As New DataTableReader(dtCusts)
dtSchema = dtrCusts.GetSchemaTable
intRows = 0
While dtrCusts.Read
intRows += 1
End While
dtrCusts.Close()
LoadDataGridViews()
Catch excXML As Exception
MsgBox(excXML.Message + excXML.StackTrace, , "DataTable ReadXml
Exception")
End Try
End Sub
Las tablas de datos DataTablestienen colecciones de ChildRelations y ParentRelations que permiten añadir código para definir las relaciones entre los diferentes objetos de las tablas de datos
múltiples. En la mayoría de los casos, sin embargo, crear un juego de datos tipificado es lo mejor
cuando se trabaja con proyectos que tienen más de una tabla de datos relacional (o relacionada).
64
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 65
Las novedades de ADO.NET 2.0
2.4 Utilizar tipos Nullable que soporten valores
DBNull
.NET Framework 2.0 añade tipos genéricos a VB.NET 2005 cuando añade el parámetro
(OfType) a las declaraciones de variable. Las variables de tipo nullable son una extensión
de tipos genéricos que permiten valores Integer, Int16, Decimal, Date, DateTime, y similares y soportan valores nulos. Asignando Nothing a un valor, éste devuelve el valor por
defecto para el tipo (0 para los tipos numéricos y 01/01/0001 12:00:00 AM para las
fechas).
Para hacer posibles los valores nulos hay que remplazar los identificadores del tipo de
valores con Nullable (OfType). Las referencias del tipo String ya soportan de por sí valores nulos, por lo que añadir Nullable (OfString) no resulta apropiado. La aplicación más
útil de las variables de tipo nullable la tenemos en las rúbricas de método, donde los
tipos de valores nullable hacen innecesaria la sobrecarga. Por ejemplo, si se inserta una
fila nueva en la tabla de pedidos Northwind (Northwind Orders) desde un juego de
datos tipificado, normalmente se necesitarán las dos rúbricas de método Insert, como
mostramos a continuación, y las dos funciones de sobrecarga correspondientes:
Function Insert(ByVal CustomerID As String,
ByVal EmployeeID As Integer, _
ByVal OrderDate As Date, _
ByVal RequiredDate As Date, _
ByVal ShippedDate As Date, _
ByVal ShipVia As Integer,
ByVal Freight As Decimal,
ByVal ShipName As String, _
ByVal ShipAddress As String,
ByVal ShipCity As String, _
ByVal ShipRegion As String,
ByVal ShipPostalCode As String, _
ByVal ShipCountry As String) As Integer
Function Insert(ByVal CustomerID As Object,
ByVal EmployeeID As Object, _
ByVal OrderDate As Object,
ByVal RequiredDate As Object, _
ByVal ShippedDate As Object, _
ByVal ShipVia As Object, _
ByVal Freight As Object, _
ByVal ShipName As Object, _
ByVal ShipAddress As Object, _
ByVal ShipCity As Object, _
ByVal ShipRegion As Object, _
ByVal ShipPostalCode As Object, _
ByVal ShipCountry As Object) As Integer
65
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 66
Bases de datos con Visual Basic
La primera rúbrica de método es válida si están presentes todos los valores. Si alguno
de los tipos de valores dados a la función es nulo, se necesita la segunda rúbrica, no
tipificada. En ese caso el código podría proporcionar un valor String en lugar de Integer
o Decimal, un error que el compilador no detectaría. Añadiendo Nullable(OfType) a los
tipos de valores, tal como mostramos aquí, permite manejar valores nulos con una sola
función:
Function Insert(ByVal CustomerID As String, _
ByVal EmployeeID As Nullable(Of Integer), _
ByVal OrderDate As Nullable(Of Date), _
ByVal RequiredDate As Nullable(Of Date), _
ByVal ShippedDate As Nullable(Of Date), _
ByVal ShipVia As Nullable(Of Integer), _
ByVal Freight As Nullable(Of Decimal), _
ByVal ShipName As String, _
ByVal ShipAddress As String, _
ByVal ShipCity As String, _
ByVal ShipRegion As String, _
ByVal ShipPostalCode As String, _
ByVal ShipCountry As String) As Integer
Si queremos definir valores para los parámetros INSERT o UPDATE asociados con
tipos nullable, deberemos comprobar que hay un valor con la propiedad HasValue y, si
el valor de HasValue es True, dárselo a la propiedad Value, tal como se muestra en el
siguiente fragmento de comando INSERT (al que se han tenido que añadir parámetros):
...
Me.InsertCommandParameters(0).Value = CustomerID
If EmployeeID.HasValue Then
Me.InsertCommandParameters(1).Value = EmployeeID.Value
Else
Me.InsertCommandParameters(1).Value = DBNull.Convert
End If
If OrderDate.HasValue Then
Me.InsertCommandParameters(2).Value = OrderDate.Value
Else
Me.InsertCommandParameters(2).Value = DBNull.Convert
End If
If RequiredDate.HasValue Then
Me.InsertCommandParameters(3).Value = RequiredDate.Value
Else
Me.InsertCommandParameters(3).Value = DBNull.Convert
End If
If ShippedDate.HasValue Then
Me.InsertCommandParameters(4).Value = ShippedDate.Value
Else
Me.InsertCommandParameters(4).Value = DBNull.Convert
End If
66
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 67
Las novedades de ADO.NET 2.0
.Nullable(OfType) también se puede aplicar a los miembros de clase Public o Private. A
continuación vemos un ejemplo de un sencillo objeto de negocios con propiedades
Public que hacen un mapa de los campos de la tabla Orders. Las reglas de negocios y las
restricciones de llave foránea determinan qué campos son de tipo nullable
(RequiredDate, ShippedDate, Freight, ShipRegion, y ShipPostalCode en este ejemplo).
ShipRegion y ShipPostalCode son tipos de referencia, nullable por definición.
Public Class Orders
Public OrderID As Integer
Public CustomerID As String
Public EmployeeID As Integer
Public OrderDate As Date
Public RequiredDate As Nullable(Of Date)
Public ShippedDate As Nullable(Of Date)
Public ShipVia As Integer
Public Freight As Nullable(Of Decimal)
...
Public ShipCountry As String
End Class
A continuación, una versión abreviada de la clase precedente, que utiliza miembros privados con accesssors Get y Set:
Public Class Orders
Private m_OrderID As Integer
Public Property OrderID() As Integer
Get
Return m_OrderID
End Get
Set(ByVal value As Integer)
m_OrderID = value
End Set
End Property
...
Private m_RequiredDate As Nullable(Of Date)
Public Property RequiredDate() As Nullable(Of Date)
Get
Return m_RequiredDate
End Get
Set(ByVal value As Nullable(Of Date))
m_RequiredDate = value
End Set
End Property
Private m_ShippedDate As Nullable(Of Date)
67
VisualBasic2005_02.qxp
02/08/2007
16:15
PÆgina 68
Bases de datos con Visual Basic
Public Property ShippedDate() As Nullable(Of Date)
Get
Return m_ShippedDate
End Get
Set(ByVal value As Nullable(Of Date))
m_ShippedDate = value
End Set
End Property
...
Private m_Freight As Nullable(Of Decimal)
Public Property Freight() As Nullable(Of Decimal)
Get
Return m_Freight
End Get
Set(ByVal value As Nullable(Of Decimal))
m_Freight = value
End Set
End Property
...
Private m_ShipCountry As String
Public Property ShipCountry() As String
Get
Return m_ShipCountry
End Get
Set(ByVal value As String)
m_ShipCountry = value
End Set
End Property
End Class
Especificar miembros de clase nullable y utilizar las propiedades HasValue y Value es
equivalente a utilizar los tests IfReferenceTypeIsNothingThen...o IfValueType=NothingThen... para los valores de propiedad asignados. Los dos tests del proyecto de ejemplo
NullableTypes.sln con objetos poblados desde un SqlDataReader de la tabla de pedidos
Orders.
2.5 Utilizar objetos persistentes de formulario
Windows de ADO.NET 2.0
Este libro define los objetos persistent como elementos que son visibles (están en la
superficie) en los formularios Windows o en la bandeja de diseño de los formularios y
cuyos valores se pueden definir en el modo diseño. Los objetos persistent se añaden
desde la categoría Datos del Cuadro de herramientas o con herramientas de generación de
68