Plataforma .NET: ADO.

NET

EL DATASET
1. ESTRUCTURA GENERAL.
El Dataset consta de dos colecciones:

Tablas Objetos DataTable, que pueden corresponderse con una tabla real de
la base de datos.

Relaciones Objetos DataRelation, que permiten navegar de una tabla a otra. No

fuerzan la integridad relacional.
Las tablas se encuentran organizadas en la coleccin Tables, y las relaciones en la
coleccin Relations.

1.1. Propiedades
Propiedad

Funcin

DataSetName

Lectura/Escritura. Nombre interno del DataSet.

EnforceConstraints Activa o desactiva las reglas de restriccin en las operaciones

de actualizacin.
HasErrors

Almacena si hay algn error en alguna tabla del DataSet.

Tables

Almacena la coleccin de Tablas.

Relations

Almacena la coleccin de relaciones.

1.2. Mtodos
Mtodo

Accin

AcceptChanges

Confirma todos los cambios en el Dataset desde que se ha

cargado o desde que se han aceptado los cambios por ltima
vez. Una vez aceptados los cambios es imposible deshacerlos,
en el DataSet.

Clear

Borra todos los datos del DataSet. Elimina todas las filas de
todas las tablas.

Clone

Duplica la estructura del Dataset

Copy

Duplica la estructura y los datos del Dataset

GetChanges

Devuelve una copia del Dataset slo con los cambios

pendientes. De esta forma es posible enviar la actualizacin
slo de los cambios, sin tener que verificar nada ms.

HasChanges

Devuelve si el DataSet tiene modificaciones o no, respecto a la

ltima carga o aceptacin de cambios.

Merge

Combina el DataSet que recibe como parmetro con el actual.

Manteniendo los cambios si se le indica. Cuando al mezclar dos
filas la clave primaria est repetida y el valor de
EnforceConstraint es True se genera un Evento de aviso :
MergeFailed.

RejectChanges

Deshace todos los cambios desde la ltima vez que se carg o

se aceptaron cambios en el Dataset.

Plataforma .NET: ADO.NET

2. COLECCIN TABLES
La coleccin Tables, como se ha indicado arriba contiene todas las tablas de un
DataSet. Como coleccin dispone de las siguientes propiedades, mtodos y
eventos:

2.1 Propiedades
Propiedad

Funcin

Count

Devuelve el nmero total de tablas de la coleccin.

Item

Obtiene el objeto DataTable que coincida con el parmetro que

recibe, bien un ndice o un nombre interno de tabla. Esta es la
propiedad por defecto, as que se puede omitir, y usar slo el
indizador, en Visual Basic los parntesis y en C# los corchetes.

2.2 Mtodos
Mtodo

Accin

Add

Aade una tabla a la coleccin.

AddRange

Aade una coleccin de tablas a la coleccin.

Clear

Borra todos los objetos de la coleccin.

Contains

Devuelve si existe o no una tabla con el nombre especificado

en la coleccin.

Remove

Elimina la tabla de la coleccin.

2.3. Objeto DataTable

Representa una tabla de datos en memoria, y es el objeto ms importante de un
DataSet, est formado, principalmente, por dos colecciones: Filas y Columnas.

2.3.1. Propiedades
Propiedad

Funcin

CaseSensitive

Indica si en las comparaciones de cadena se distingue entre

maysculas y minsculas.

ChildRelations

Devuelve la coleccin de relaciones secundarias en las que

participa esta tabla.

Columns

Devuelve la coleccin de columnas de la tabla.

Constraints

Devuelve la coleccin de restricciones de la tabla

Dataset

Devuelve el DataSet al que pertenece la tabla.

DefaultView

Devuelve una vista personalizada de la tabla. Permite filtrar los

datos almacenados, o mostrarlos en otro orden.

HasErrors

Devuelve si la tabla contiene errores o no.

ParentRelations

Devuelve la coleccin de relaciones primarias en las que

participa esta tabla.

PrimaryKey

Lectura/Escritura. Almacena la
funcionan como clave primaria.

Rows

Devuelve la coleccin de filas de la tabla.

TablaName

Lectura/Escritura. Almacena el nombre de la tabla.

matriz

de

columnas

que

Plataforma .NET: ADO.NET

2.3.2. Mtodos
Mtodo

Accin

AcceptChanges

Confirma todos los cambios realizados en la tabla desde que se

ha cargado o desde que se han aceptado los cambios por
ltima vez. Una vez aceptados los cambios es imposible
deshacerlos, en la tabla.

BeginInit

Activa la inicializacin de la tabla. Permite hacer uso de la tabla

antes de que realmente se cargue.

BeginLoadData

Desactiva todas las notificaciones mientras se cargan los datos.

Clear

Borra todos los datos de la tabla.

Clone

Clona la estructura de la tabla, incluidos todos los esquemas y

restricciones.

Compute

Calcula el valor de una expresin para todas aquellas filas que

cumplan el filtro.

Copy

Copia la estructura y los datos de la tabla.

EndInit

Finaliza la inicializacin de la tabla.

GetChanges

Devuelve una tabla slo con los cambios existentes.

GetErrors

Devuelve la coleccin de filas que tengan error.

ImportRow

Copia una fila en una tabla, manteniendo todos los valores de

la misma.

LoadDataRow

Busca y actualiza una fila, si no lo encuentra se crea una nueva

con dichos valores.

NewRow

Crea y devuelve una fila en blanco con el esquema de la tabla,

pero no la aade a la coleccin de filas de la tabla.

RejectChanges

Deshace todos los cambios que se hayan realizado en la tabla.

Select

Devuelve un array de filas con todas aquellas que cumplan los

criterios. El criterio es una cadena de caracteres con la
condiciones de una clusula WHERE de SQL

2.3.3. Eventos
Evento

Ocurre cuando

ColumnChanged

Cambia el valor de la columna

ColumnChanging

Est cambiando el valor de la columna

RowChanged

Cambia el valor de la fila

RowChanging

Est cambiando el valor de la fila

RowDeleted

Se ha eliminado una fila

RowDeleting

Se va a eliminar una fila

NOTA: No hay evento cuando se aade una fila.

Plataforma .NET: ADO.NET

3.COLECCIN COLUMNS
Almacena la coleccin de columnas que pertenecen a la tabla. Las propiedades y
mtodos son las comunes a todas las colecciones.

3.1 Propiedades
Propiedad

Funcin

Count

Devuelve el nmero total de columnas de la coleccin.

Item

Obtiene el objeto DataColumn que coincida con el parmetro

que recibe, bien un ndice o un nombre interno de columna.
Esta es la propiedad por defecto, as que se puede omitir, y
usar slo el indizador, en Visual Basic los parntesis y en C# los
corchetes.

3.2 Mtodos
Mtodo

Accin

Add

Aade una columna a la coleccin.

AddRange

Aade una coleccin de columnas a la coleccin.

Clear

Borra todos los objetos de la coleccin.

Contains

Devuelve si existe o no
especificado en la coleccin.

Remove

Elimina la columna de la coleccin.

una

columna

con

el

nombre

3.3 Objeto DataColum

Representa el esquema de una columna en un DataTable.

3.3.1. Propiedades
Propiedad

Funcin

AllowDBNull

Lectura/Escritura. Almacena si se permiten valores nulos para

esa columna o no.

AutoIncrement

Lectura/Escritura. Almacena si esa columna se incrementa

automticamente o no al aadir una fila, utilizado en
autonumricos. Con esta propiedad existen otras, de menor
relevancia, que permiten modificar el valor del incremento, el
valor inicial.

ColumnName

Nombre interno de la columna.

DataType

Lectura/Escritura. Almacena el tipo de datos de los datos

almacenados en esa columna.

DefaulValue

Valor por defecto al aadir nuevas filas.

Expression

Lectura/Ecritura. Almacena la expresin utilizada para filtrar

filas, calcular el valor de la columna o crear una columna
agregada. Se utiliza para crear columnas calculadas.

MaxLength

Lectura/escritura. Almacena la longitud mxima cuando el tipo

almacenado estexto.

Ordinal

Almacena la posicin de la columna dentro de la colccin.

ReadOnly

Lectura/Escritura. Almacena si el valor de la columna se puede

modificar.

Plataforma .NET: ADO.NET

Propiedad

Funcin

Table

Devuelve una referencia a la tabla a la que pertenece la

columna.

Unique

Lectura/Escritura. Almacena si los valores de la columna son

nicos o no.

NOTA: Este objeto carece de mtodos y eventos relevantes, ya que los que
tiene son heredados de Object.

Plataforma .NET: ADO.NET

4. COLECCIN ROWS
Almacena la coleccin de filas que pertenecen a la tabla. Las propiedades y
mtodos son casi las mismas que las de cualquier otra coleccin, aunque, por
ejemplo, carece del mtodos AddRange.

4.1 Propiedades
Propiedad

Funcin

Count

Devuelve el nmero total de filas de la coleccin.

Item

Obtiene el objeto DataRow que coincida con el parmetro que

recibe, en este caso slo puede ser un ndice.Esta es la
propiedad por defecto, as que se puede omitir, y usar slo el
indizador, en Visual Basic los parntesis y en C# los corchetes.

4.2. Mtodos
Mtodo

Accin

Add

Aade una fila a la coleccin.

Clear

Borra todos los objetos de la coleccin.

Contains

Devuelve si existe o no una fila con el nombre especificado en

la coleccin.

Find

Devuelve la fila cuyos campos clave coincidan con los que

recibe como parmetro. Realiza una bsqueda por el
PrimaryKey de la tabla. Si no existe devuelve Nothing.

InsertAt

Inserta la fila que recibe como parmetro en la posicin que se

le indica.

Remove

Elimina la fila que recibe de la coleccin.

RemoveAt

Elimina la fila cuyo ndice recibe de la coleccin

4.3. Objeto DataRow

Representa una fila de datos, DataRow, en una tabla.

4.3.1. Propiedades
Propiedad

Funcin

HasErrors

Lectura/Escritura. Almacena si hay errores en la fila o no.

Item

Lectura/Escritura. Almacena los datos almacenados en la

columna que coincida con el parmetro que recibe. La columna
se puede especificar por su ndice, Ordinal, o su nombre. Esta
es la propiedad por defecto, as que se puede omitir, y usar
slo el indizador, en Visual Basic los parntesis y en C# los
corchetes.

ItemArray

Lectura/Escritura. Almacena los valores de la fila mediante una

matriz.

RowError

Lectura/Escritura. Almacena la descripcin de error para esa

fila.

RowState

Lectura/Escritura. Almacena el estado actual de la fila. El valor

de esta propiedad depende de dos factores, el tipo de
operacin realizada en la fila y de si se ha llamado o no al
mtodo AcceptChanges. Los posibles valores son:

Added: La fila se ha agregado a la coleccin, pero o se ha

llamado a AcceptChanges

Plataforma .NET: ADO.NET

Table

Deleted: La fila ha sido borrada mediante el mtodo Delete

del Datarow

Detached: Se ha creado la fila, pero todava no ha sido

aadida, mtodo Add, de momento es hurfana.

Modified: La fila se ha modificado y no se ha llamado a

AcceptChanges.

Unchanged: La fila no ha cambiado desde que se llam a

AcceptChanges por ltima vez.

Devuelve una referencia a la tabla a la que pertenece la fila.

4.3.2. Mtodos
Mtodo

Accin

AcceptChanges

Confirma todos los cambios realizados en la fila. Si la

propiedad RowState era Deleted, la fila se elimina de la
coleccin, en cualquier otro caso se establece su valor a
Unchanged.

BeginEdit

Inicia la operacin de edicin.

CancelEdit

Cancela la edicin de la fila.

ClearErrors

Borra todos los errores de la fila.

Delete

Elimina la fila.

EndEdit

Termina la edicin de la fila.

GetChildRows

Devuelve las filas secundarias, establecidas a travs de una

relacion.

GetColumnError

Devuelve la descripcin de error para una columna.

GetColumnsInError Devuelve un array con las columnas que tienen errores.

GetParentRow

Devuelve la fila primaria a la que pertenece esta fila, este valor

viene derivado de las relaciones establecidas.

GetParentRows

Devuelve un array con todas las filas primarias.

IsNull

Almacena si la columna especificada contiene un valor nulo.

RejectChanges

Anula todos los cambios realizados.

SetColumnError

Asigna una descripcin del error a una columna.

SetParentRow

Asigna la fila primaria de la fila.

Plataforma .NET: ADO.NET

5. COLECCIN RELATIONS
Es la coleccin de relaciones que vincula las tablas y permite el desplazamiento
desde tablas primarias a secundarias. Las propiedades y mtodos son las comunes
a todas las colecciones.

5.1 Propiedades
Propiedad

Funcin

Count

Devuelve el nmero total de relaciones de la coleccin.

Item

Obtiene el objeto DataRelation que coincida con el parmetro

que recibe, bien un ndice o un nombre interno de relacin.
Esta es la propiedad por defecto, as que se puede omitir, y
usar slo el indizador, en Visual Basic los parntesis y en C# los
corchetes.

5.2 Mtodos
Mtodo

Accin

Add

Aade una relacin a la coleccin.

AddRange

Aade una coleccin de relaciones a la coleccin.

Clear

Borra todos los objetos de la coleccin.

Contains

Devuelve si existe o no una relacin con el nombre especificado

en la coleccin.

Remove

Elimina la columna que recibe como parmetro de la coleccin.

5.3. Objeto DataRelation

Representa una relacin, DataRelation, primaria-secundaria entre dos tablas. Se
habla de relacin primaria cuando se est en la tabla origen de la relacin, la de la
izquierda, y de relacin secundaria cuando se est en la tabla destino de la relacin,
la de la derecha

5.3.1. Propiedades
Propiedad

Funcin

ChildColumns

Devuelve un array con todos las columnas secundarios de la

relacin.

ChildKeyConstraint

Devuelve el ForeingKeyConstraint de la relacin, que es una

relacin entre una clave principal y una externa. Hace
referencia al a actualizacin o eliminacin en cascada.

ChildTable

Devuelve la tabla secundaria de la relacin.

DataSet

Devuelve el dataset al que pertenece.

ParentClumns

Devuelve un array con todos las columnas primarias de la

relacin.

ParenKeyConstraint Devuelve el UniqueConstraint de la relacin, que garantiza la

unicidad de los valores de la columna primaria. Hace referncia
a la integridad referencial.
ParentTable

Devuelve la tabla primaria, la origen, de la relacin.

RelationName

Lectura/Escritura. Almacena el nombre interno de la relacin.

NOTA: Este objeto carece de mtodos y eventos relevantes, ya que los que
tiene son heredados de Object.

Plataforma .NET: ADO.NET

6. COLECCIN COSTRAINTS
Representa la coleccin de restricciones de una tabla. Esta coleccin est forma da
por dos tipos de objetos:

UniqueConstraint.

ForeingKeyConstraint.

6.1. Objeto UniqueConstraint

Representa una restriccin a un conjunto de columnas en las que todos los valores
deben ser nicos, son las restricciones de unicidad. Cada columna independiente
puede tener valores repetidos, pero la combinacin de los valores de todas las
columnas que forman parte de la restriccin, para esa fila, debe ser nica.

6.1.1. Propiedades
Propiedad

Funcin

Columns

Devuelve el array de columnas a las que afecta la restriccin.

ConstraintName

Nombre interno de la restriccin.

IsPrimaryKey

Devuelve si este restriccin est o no en una clave principal.

Table

Devuelve la tabla a la que pertenece la restriccin.

NOTA: Este objeto carece de mtodos y eventos relevantes, ya que los que
tiene son heredados de Object.

6.2. Objeto ForeingKeyConstraint

Representa las restricciones que mantienen la integridad relacional, es decir, las
que impiden que una o ms filas de una tabla secundaria, queden hurfanas al
desaparecer la fila de la tabla primaria. Restringe la accin a realizar cuando se
elimina o actualiza un valor de columnas. Este tipo de restriccin est pensado para
utilizarlo con columnas de clave principal. En una relacin la eliminacin de un valor
de la tabla primaria puede afectar las filas secundarias de una de las formas
siguientes.

Tambin se pueden eliminar las filas secundarias (accin en cascada).

Los valores de las columnas secundarias se pueden establecen en nulos.

Los valores de
predeterminados.

Se puede generar una excepcin.

las

columnas

secundarias

se

pueden

establecer

en

6.1.1. Propiedades
Propiedad

Funcin

AcceptRejectRule

Indica la accin a llevar a cabo cuando

AcceptChanges. Los posibles valores son:

se

llama

Cascade: Los cambios se desencadenan en cascada a travs

de la relacin.

None: No se realiza ninguna accin. Valor por defecto.

SetDefault: Establece a valores por defecto.

SetNull: Establece a valor nulo.

Columns

Devuelve el array de columnas a las que afecta la restriccin.

ConstraintName

Nombre interno de la restriccin.

Plataforma .NET: ADO.NET

DeleteRule

Indica la accin a llevar a cabo cuando se elimina una fila. Los

valores son los mismos que para AcceptRejectRule, para ser
exactos AcceptRejectRule verifica el valor de DeleteRule y el de
UpdateRule para cada fila.

RelatedColumns

Devuelve el array de columnas primarias de la restriccin.

RelatedTable

Devuelve la tabla primaria de la restriccin.

Table

Devuelve la tabla secundaria de la restriccin.

UpdateRule

Establece la accin a realizar cuando se actualiza una fila, es

igual que DeleteRule, pero para la actualizacin de filas.

NOTA: Este objeto carece de mtodos y eventos relevantes, ya que los que
tiene son heredados de Object.

10

Plataforma .NET: ADO.NET

7. OBJETO DATAVIEW
Un objeto Dataview representa una vista personalizada que enlaza los datos de una
tabla, para permitir la ordenacin ,filtrado, bsqueda, edicin y exploracin de los
datos que se almacenan en un DataTable. Un objeto de este tipo sirve para indicar
con qu datos de todos los que han sido cargados trabaja el usuario. Esto no quiere
decir que los datos que no aparezcan en la vista se elimine, si no que nicmente se
ocultan al usuario.

7.1. Propiedades
Propiedad

Funcin

AllowDelete

Lectura/Escritura. Almacena un valor que indica si se permite

eliminar o no filas de la vista.

AllowEdit

Lectura/Escritura. Almacena un valor que indica si se permite

modificar o no los valores de las filas de la vista.

AllowNew

Lectura/Escritura. Almacena un valor que indica si se permite

filas nuevas, mediante el AddNew, o no a la vista.

Count

Devuelve el nmero de filas de las vista despus de aplicar el

filtro.

Item

Devuelve la fila cuyo ndice recibe como parmetro. Es la

prpiedad por defecto, as que se puede suprimir y utilizar los
parntesis como indizador, en C# seran los corchetes.

RowFilter

Lectura/Escritura. Almacena la expresin que se utiliza para

filtrar las filas que se van a mostrar en el DataView . Esta
expresin es una cadena de caracteres con la condiciones de
una clusula WHERE de SQL.

RowStateFilter

Lectura/Escritura. Almacena el filtro para el estado de las filas

que se quieren mostrar en la vista.

Sort

Lectura/Escritura. Almacena el criterio de ordenacin de los

datos de la vista. Es una cadena de caracteres con la parte del
ORDER BY de una consulta SQL.

Table

Lectura/Escritura. Almacena la tabla de origen.

7.2. Mtodos
Mtodo

Accin

AddNew

Aade la fila que recibe como parmetro a la vista.

Delete

Elimina de la vista la fila cuyo ndice recibe como parmetro.

Find

Devuelve la fila de la vista cuya clave de ordenacin coincida

con el valor que recibe como parmetro.

FindRows

Devuelve el array de filas de la vista cuya clave de ordenacin

coincida con el valor que recibe como parmetro.

7.3. Eventos
Evento

Ocurre cuando

ListChanged

La lista administrada por el DatView cambia.

11