DataSet. DataSet (System.Data):

Transcripción

1 (System.Data): El de ADO.NET es una representación de datos residente en memoria que proporciona un modelo de programación relacional coherente independientemente del origen de datos que contiene. Un representa un conjunto completo de datos, incluyendo las tablas que contienen, ordenan y restringen los datos, así como las relaciones entre las tablas. Hay varias maneras de trabajar con un, que se pueden aplicar de forma independiente o conjuntamente. Crear mediante programación una DataTable, DataRelation y una Constraint (restricción) en un y rellenar las tablas con datos. Llenar el con tablas de datos de un origen de datos relacional existente mediante DataAdapter. Cargar y hacer persistente (guardar) el contenido de mediante XML. También se puede transportar un con establecimiento inflexible de tipos mediante un servicio Web XML (WebService). El diseño del lo convierte en idóneo para el transporte de datos mediante servicios Web XML.

2 Algunos métodos del : Clear: Borra cualquier dato de mediante el procedimiento de quitar todas las filas de todas las tablas. Clone: Copia la estructura de, incluidos todos los esquemas, relaciones y restricciones de DataTable. No copia ningún dato. Copy: Copia la estructura y los datos para este objeto. HasChanges Obtiene un valor que indica si presenta cambios, incluyendo filas nuevas, eliminadas o modificadas. Merge Combina un objeto especificado y su esquema en el objeto actual. WriteXml(string filename, XmlWriteMode mode) Escribe los datos actuales y, de forma opcional, el esquema para el objeto en el archivo indicado mediante la enumeración XmlWriteMode especificada. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema. WriteSchema: Escribe el contenido actual de como datos XML con la estructura relacional como un esquema XSD en línea. Si el sólo tiene un esquema sin datos, únicamente se escribe el esquema en línea. Si el no tiene un esquema actual, no se escribe nada. IgnoreSchema: Escribe el contenido actual de como datos XML, sin un esquema XSD. Si no se cargan datos en el, no se escribe nada. DiffGram: Escribe el completo como un DiffGram, incluidos los valores originales y actuales. Para generar un DiffGram que contenga únicamente valores modificados, llame a GetChanges y, a continuación, llame a WriteXml como un DiffGram del devuelto. Ejemplo: dsviajes; dsviajes = Viajes.ObtenerTodosDS(); dsviajes.writexml(@"f:\temp\datos.xml", XmlWriteMode.WriteSchema);

3 ReadXml(string filename, XmlReadMode mode) Lee el esquema y los datos XML del mediante el archivo y el XmlReadMode especificados. Auto (default): Realiza la acción más apropiada de las que se muestran a continuación. Si los datos constituyen un DiffGram, establece XmlReadMode en DiffGram, o bien si el conjunto de datos ya tiene un esquema o el documento contiene un esquema en línea, establece XmlReadMode en ReadSchema. O bien, si el conjunto de datos aún no tiene un esquema y el documento no contiene un esquema en línea, establece XmlReadMode en InferSchema. ReadSchema: Lee cualquier esquema en línea y carga los datos. Si el ya contiene un esquema, se pueden agregar al mismo las nuevas tablas, aunque se producirá una excepción si cualquier tabla del esquema en línea ya existe en el. IgnoreSchema: Omite cualquier esquema en línea y lee los datos del esquema del existente. Si los datos constituyen un DiffGram, IgnoreSchema tiene la misma funcionalidad que DiffGram. InferSchema: Omite cualquier esquema en línea, deduce el esquema a partir de los datos y los carga. Si el ya contiene un esquema, se extiende el esquema actual mediante la adición de nuevas tablas o la adición de columnas a las tablas existentes. Se producirá una excepción si la tabla deducida ya existe con un espacio de nombres distinto, o si cualquiera de las columnas deducidas entra en conflicto con las columnas existentes. DiffGram: Lee un DiffGram, aplicando los cambios del DiffGram a. La semántica es idéntica a la de una operación Merge. Al igual que ocurre con la operación Merge, se conservan los valores RowState. La entrada a ReadXml mediante DiffGrams sólo se puede obtener si se utiliza la salida de WriteXml como un DiffGram. El de destino debe tener el mismo esquema que el en el que se llama a WriteXml como DiffGram. De lo contrario, se producirá un error en la operación de combinación de DiffGram y se producirá una excepción. Fragment: Lee fragmentos XML, como los que se generan al ejecutar consultas FOR XML, en una instancia de SQL Server. Al establecer XmlReadMode en Fragment, se lee el espacio de nombres predeterminado como el esquema en línea. InferTypedSchema: Omite cualquier esquema en línea, deduce el esquema con establecimiento inflexible de tipos a partir de los datos y los carga. Si el tipo no se puede deducir de los datos, se interpreta como datos de cadena. Si el ya contiene un esquema, se extiende el esquema actual mediante la adición de nuevas tablas o columnas a las tablas existentes. Se producirá una excepción si la tabla deducida ya existe con un espacio de nombres distinto, o si cualquiera de las columnas deducidas entra en conflicto con las columnas existentes. Algunas propiedades del : Name: Obtiene o establece el nombre del objeto actual. Relations: Obtiene la colección de relaciones que vincula las tablas y permite el desplazamiento desde las tablas primarias a las secundarias. Tables: Obtiene la colección de tablas incluidas en.

4

5 DataTable (System.Data): Una DataTable representa una tabla de datos en memoria. Si se va a crear un DataTable mediante programación, en primer lugar se debe definir su esquema agregando objetos DataColumn al DataColumnCollection (al que se obtiene acceso mediante la propiedad Columns). Para obtener más información sobre la adición de objetos DataColumn, vea Agregar columnas a una tabla. Para agregar filas a DataTable, en primer lugar se debe utilizar el método NewRow para devolver un nuevo objeto DataRow. El método NewRow devuelve una fila con el esquema de DataTable, tal como lo define el DataColumnCollection de la tabla. El número máximo de filas que puede almacenar un objeto DataTable es Para obtener más información, vea Agregar datos a una tabla. DataTable también contiene una colección de objetos Constraint que se pueden utilizar para asegurar la integridad de los datos. Para obtener más información, vea Agregar restricciones a una tabla. DataRow (Clase) Representa una fila de datos en un DataTable. Los objetos DataRow y DataColumn son componentes principales de un DataTable. Utilice el objeto DataRow y sus propiedades y métodos para recuperar, evaluar, insertar, eliminar y actualizar los valores de DataTable. DataRowCollection representa los objetos DataRow reales de DataTable y DataColumnCollection contiene los objetos DataColumn que describen el esquema de DataTable. Utilice la propiedad Item sobrecargada para devolver o establecer el valor de DataColumn. Utilice las propiedades HasVersion y IsNull para determinar el estado de un valor de fila concreto y la propiedad RowState para determinar el estado de la fila con relación a su objeto DataTable primario. Para crear un DataRow nuevo, utilice el método NewRow del objeto DataTable. Después de crear un DataRow nuevo, utilice el método Add para agregar el nuevo DataRow a DataRowCollection. Por último, llame al método AcceptChanges del objeto DataTable para confirmar la adición. Para obtener más información sobre la adición de datos a un DataTable, vea Agregar datos a DataTable. Puede eliminar un DataRow de DataRowCollection llamando al método Remove de DataRowCollection, o bien llamando al método Delete del objeto DataRow. El método Remove quita de la colección la fila. En cambio, Delete marca el DataRow que se va a quitar. La eliminación real se produce cuando se llama al método AcceptChanges. Al llamar a Delete, se puede comprobar mediante programación qué filas están marcadas para eliminación antes de eliminarlas.

6 DataColumn (Clase) Representa el esquema de una columna en un DataTable. El DataColumn es el bloque constructivo fundamental para crear el esquema de un DataTable. Para construir el esquema, se agregan uno o varios objetos DataColumn al DataColumnCollection. Cada DataColumn tiene una propiedad DataType que determina el tipo de datos que contiene el DataColumn. Por ejemplo, se puede restringir el tipo de datos a enteros, cadenas o decimales. Puesto que los datos incluidos en el objeto DataTable normalmente se vuelven a combinar en su origen de datos original, se debe hacer coincidir los tipos de los datos con los del origen de datos Propiedades como AllowDBNull, Unique y ReadOnly aplican restricciones en la entrada y actualización de datos, lo que contribuye a garantizar la integridad de éstos. También se pueden utilizar las propiedades AutoIncrement, AutoIncrementSeed y AutoIncrementStep para controlar la generación automática de datos. También se puede garantizar que los valores de un objeto DataColumn son únicos mediante la creación de una restricción UniqueConstraint y su adición a la colección ConstraintCollection del objeto DataTable al que pertenece el objeto DataColumn. Para crear una relación entre objetos DataColumn, cree un objeto DataRelation y agréguelo al DataRelationCollection de un. También se puede utilizar la propiedad Expression del objeto DataColumn para calcular los valores de una columna o para crear una columna agregada. DataRowView (Miembros) Representa una vista personalizada de DataRow. Cuando se muestran datos, como en un control DataGrid, sólo se puede mostrar una versión de cada fila. La fila que se muestra es un DataRowView. DataRowView sólo puede tener uno de los cuatro estados de versión diferentes: Default, Original, Current y Proposed. Tras invocar BeginEdit en un DataRow, cualquier valor que se haya editado se convertirá en el valor Proposed. Hasta que se invoque a CancelEdit o a EndEdit, la fila tendrá una versión Original y otra Proposed. Si se invoca a CancelEdit, se descartará la versión propuesta y el valor volverá a ser Original. Si se invoca a EndEdit, el objeto DataRowView dejará de tener una versión Proposed. En su lugar, el valor propuesto se convertirá en el valor actual. Los valores predeterminados sólo se encuentran disponibles en las filas que tienen columnas con valores predeterminados definidos.