System.Data Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Ofrece acceso a clases que representan la arquitectura de ADO.NET. ADO.NET permite crear componentes que administran datos de varios orígenes de datos con eficacia.
Clases
Constraint |
Representa una restricción que se puede forzar en uno o más objetos DataColumn. |
ConstraintCollection |
Representa una colección de restricciones para una tabla DataTable. |
ConstraintException |
Representa la excepción que se produce cuando se intenta realizar una acción que infringe una restricción. |
DataColumn |
Representa el esquema de una columna en una DataTable. |
DataColumnChangeEventArgs |
Proporciona datos para el evento ColumnChanging. |
DataColumnCollection |
Representa una colección de objetos DataColumn de una tabla DataTable. |
DataException |
Representa la excepción que se produce cuando se generan errores al utilizar componentes ADO.NET. |
DataReaderExtensions |
Proporciona métodos de extensión para DbDataReader. |
DataRelation |
Representa una relación primaria-secundaria entre dos objetos DataTable. |
DataRelationCollection |
Representa la colección de objetos DataRelation de este DataSet. |
DataRow |
Representa una fila de datos en un DataTable. |
DataRowBuilder |
El tipo |
DataRowChangeEventArgs |
Proporciona datos para los eventos RowChanged, RowChanging, OnRowDeleting(DataRowChangeEventArgs) y OnRowDeleted(DataRowChangeEventArgs). |
DataRowCollection |
Representa una colección de filas para un DataTable. |
DataRowComparer |
Devuelve una instancia singleton de la clase DataRowComparer<TRow>. |
DataRowComparer<TRow> |
Compara si dos objetos DataRow son equivalentes mediante la comparación basada en valores. |
DataRowExtensions |
Define los métodos de extensión para la clase DataRow. Se trata de una clase estática. |
DataRowView |
Representa una vista personalizada de un elemento DataRow. |
DataSet |
Representa una caché de datos en memoria. |
DataSetSchemaImporterExtension |
Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código. |
DataSysDescriptionAttribute |
Marca una propiedad, un evento o un extensor con una descripción. Los diseñadores visuales pueden mostrar esta descripción al hacer referencia al miembro. |
DataTable |
Representa una tabla de datos en memoria. |
DataTableClearEventArgs |
Proporciona datos para el método Clear(). |
DataTableCollection |
Representa la colección de tablas para el DataSet. |
DataTableExtensions |
Define los métodos de extensión para la clase DataTable. DataTableExtensions es una clase estática. |
DataTableNewRowEventArgs |
Proporciona datos para el método NewRow(). |
DataTableReader |
El DataTableReader obtiene el contenido de uno o más objetos DataTable con formato de uno o más conjuntos de solo lectura y de solo avance. |
DataView |
Representa una vista personalizada enlazables de datos de un objeto DataTable para ordenación, filtrado, búsqueda, edición y navegación. DataView no almacena datos, pero en su lugar representa una vista conectada de su DataTable correspondiente. Los cambios en los datos de DataView afectan a DataTable. Los cambios en los datos de DataTable afectan a todos los elementos DataView asociados a él. |
DataViewManager |
Contiene un valor predeterminado de DataViewSettingCollection para cada DataTable de DataSet. |
DataViewSetting |
Representa la configuración predeterminada para ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort y Table para los DataViews creados a partir de DataViewManager. |
DataViewSettingCollection |
Contiene una colección de sólo lectura de objetos DataViewSetting para cada DataTable de un DataSet. |
DBConcurrencyException |
Excepción que inicia DataAdapter durante una operación de inserción, actualización o eliminación si el número de filas afectadas es igual a cero. |
DeletedRowInaccessibleException |
Representa la excepción que se produce al intentar realizar una acción en un objeto DataRow que se ha eliminado. |
DuplicateNameException |
Representa la excepción que se produce cuando se encuentra un nombre de objeto de base de datos duplicado durante una operación de agregar en un objeto relacionado con DataSet. |
EntityCommandCompilationException |
Representa los errores que se producen durante la compilación de los comandos, cuando no ha sido posible generar un árbol de comandos para representar el texto de comando. |
EntityCommandExecutionException |
Representa los errores que se producen cuando el proveedor de almacenamiento subyacente no puede ejecutar el comando especificado. Esta excepción normalmente ajusta una excepción específica del proveedor. |
EntityException |
Representa los errores relacionados con Entity Framework que se producen en el espacio de nombres |
EntityKey |
Proporciona una referencia duradera a un objeto que es una instancia de un tipo de entidad. |
EntityKeyMember |
Representa un par nombre de clave-valor de clave que forma parte de una EntityKey. |
EntitySqlException |
Representa los errores que se producen al analizar el texto de los comandos de Entity SQL. Esta excepción se produce cuando se infringen las reglas sintácticas o semánticas. |
EnumerableRowCollection |
Representa una colección de objetos DataRow devuelta desde una consulta de LINQ to DataSet. Esta API admite la infraestructura .NET y no está diseñada para usarse directamente desde el código. |
EnumerableRowCollection<TRow> |
Representa una colección de los objetos DataRow que devuelve una consulta. |
EnumerableRowCollectionExtensions |
Contiene los métodos de extensión para las clases de colección de filas de datos. |
EvaluateException |
Representa la excepción que se produce cuando no se puede evaluar la propiedad Expression de DataColumn. |
FillErrorEventArgs |
Proporciona datos para el evento FillError de DbDataAdapter. |
ForeignKeyConstraint |
Representa la restricción de una acción impuesta a un conjunto de columnas en una relación entre clave principal y clave externa cuando se elimina o actualiza un valor o una fila. |
InRowChangingEventException |
Representa la excepción que se produce al llamar al método EndEdit() en el evento RowChanging. |
InternalDataCollectionBase |
Proporciona la funcionalidad base para crear colecciones. |
InvalidCommandTreeException |
Excepción que se produce para indicar que un árbol de comandos no es válido. Actualmente, esta excepción no se inicia en Entity Framework. |
InvalidConstraintException |
Representa la excepción que se produce al intentar crear una relación u obtener acceso a la misma de forma incorrecta. |
InvalidExpressionException |
Representa la excepción que se produce al intentar agregar a una colección DataColumn un objeto Expression que contiene una propiedad DataColumnCollection no válida. |
MappingException |
Excepción que se produce cuando las solicitudes de servicios relacionados de asignaciones sufren un error. |
MergeFailedEventArgs |
Se produce cuando unos |
MetadataException |
Excepción que se produce cuando las solicitudes de servicios relacionados de metadatos sufren un error. |
MissingPrimaryKeyException |
Representa la excepción que se produce al intentar obtener acceso a una fila de una tabla que no tiene clave principal. |
NoNullAllowedException |
Representa la excepción que se produce cuando se intenta insertar un valor null en una columna donde el valor de AllowDBNull está establecido en |
ObjectNotFoundException |
Excepción que se produce cuando un objeto no está presente. |
OperationAbortedException |
Esta excepción se produce cuando el usuario anula una operación en curso. |
OptimisticConcurrencyException |
Excepción que se produce cuando tiene lugar una infracción de la simultaneidad optimista. |
OrderedEnumerableRowCollection<TRow> |
Representa una colección de objetos DataRow ordenados devueltos desde una consulta. |
PropertyCollection |
Representa una colección de propiedades que se pueden agregar al DataColumn, DataSet o DataTable. |
PropertyConstraintException |
Clase de excepción de restricción de propiedades. Observe que esta clase tiene un estado, por lo que si modifica incluso sus elementos internos, puede ser un cambio importante. |
ProviderIncompatibleException |
Excepción que se produce cuando el proveedor de datos subyacente es incompatible con Entity Framework. |
ReadOnlyException |
Representa la excepción que se produce al intentar cambiar el valor de una columna de sólo lectura. |
RowNotInTableException |
Representa la excepción que se produce al intentar realizar una operación en un objeto DataRow que no se encuentra en un objeto DataTable. |
StateChangeEventArgs |
Proporciona los datos para el evento de cambio de estado de un proveedor de datos de .NET. |
StatementCompletedEventArgs |
Proporciona información adicional del evento StatementCompleted. |
StrongTypingException |
Excepción que produce un DataSet fuertemente tipado cuando el usuario obtiene acceso a un valor |
SyntaxErrorException |
Representa la excepción que se produce cuando la propiedad Expression de un DataColumn contiene un error de sintaxis. |
TypedDataSetGenerator |
Se utiliza para crear un DataSet fuertemente tipado. |
TypedDataSetGeneratorException |
Excepción que se produce cuando se produce un conflicto de nombres mientras se genera un DataSet fuertemente tipado. |
TypedTableBase<T> |
Este tipo se usa como clase base para la generación de objetos de tipo DataTable por parte de Visual Studio y la herramienta XSD.exe .NET Framework y no está pensado para usarse directamente desde el código. |
TypedTableBaseExtensions |
Contiene los métodos de extensión para la clase TypedTableBase<T>. |
UniqueConstraint |
Representa una restricción en un conjunto de columnas en el que todos los valores deben ser únicos. |
UpdateException |
Excepción que se produce cuando las modificaciones a instancias de objetos no se pueden conservar en el origen de datos. |
VersionNotFoundException |
Representa la excepción que se produce al intentar devolver una versión de un objeto DataRow que se ha eliminado. |
Interfaces
IColumnMapping |
Asocia una columna del origen de datos a una columna de un DataSet. La implementa la clase DataColumnMapping, que utilizan todos los proveedores de datos de .NET. |
IColumnMappingCollection |
Contiene una colección de objetos DataColumnMapping y la implementa DataColumnMappingCollection, que utiliza todos los proveedores de datos de .NET. |
IDataAdapter |
Permite que un objeto implemente un DataAdapter. Representa un conjunto de métodos y propiedades relacionadas con acciones de asignación que se usan para rellenar y actualizar un DataSet y actualizar un origen de datos. Las instancias IDbDataAdapter son para los orígenes de datos que son (o se asemejan a) bases de datos relacionales con comandos textuales (como Transact-SQL), mientras que las instancias IDataAdapter pueden usar cualquier tipo de origen de datos. |
IDataParameter |
Representa un parámetro para un objeto Command y, opcionalmente, sus asignaciones a columnas DataSet; además, se implementa mediante proveedores de datos de .NET que acceden a orígenes de datos. |
IDataParameterCollection |
Recopila todos los parámetros relevantes para un objeto Command y sus asignaciones a columnas DataSet y se implementa mediante proveedores de datos de .NET que acceden a orígenes de datos. |
IDataReader |
Proporciona un medio para leer una o más secuencias de solo hacia delante de conjuntos de resultados que se obtienen al ejecutar un comando en un origen de datos y se implementa mediante proveedores de datos .NET que tienen acceso a bases de datos relacionales. |
IDataRecord |
Proporciona acceso a los valores de columna dentro de cada fila para |
IDbCommand |
Representa una instrucción SQL que se ejecuta mientras hay conexión con un origen de datos y se implementa mediante proveedores de datos .NET que acceden a bases de datos relacionales. |
IDbConnection |
Representa una conexión abierta a un origen de datos y se implementa mediante proveedores de datos de .NET que acceden a bases de datos relacionales. |
IDbDataAdapter |
Representa un conjunto de propiedades relacionadas con comandos que se utilizan para rellenar DataSet y actualizar un origen de datos, y la implementan los proveedores de datos de .NET que tienen acceso a bases de datos relacionales. |
IDbDataParameter |
Lo utilizan los diseñadores de datos de Visual Basic .NET para representar un parámetro a un objeto de comando y, opcionalmente, su asignación a columnas DataSet. |
IDbTransaction |
Representa una transacción para realizar en un origen de datos y se implementa mediante proveedores de datos de .NET que acceden a bases de datos relacionales. |
IExtendedDataRecord |
Proporciona acceso a los valores de columna dentro de cada fila de un DbDataRecord para un DbDataReader. |
ITableMapping |
Asocia una tabla de origen a una tabla de DataSet. La implementa la clase DataTableMapping, que utilizan todos los proveedores de datos de .NET. |
ITableMappingCollection |
Contiene una colección de objetos TableMapping. La implementa la clase DataTableMappingCollection, que utilizan todos los proveedores de datos de .NET. |
Enumeraciones
AcceptRejectRule |
Determina la acción que se produce cuando se invoca a los métodos AcceptChanges() o RejectChanges() en un DataTable con un ForeignKeyConstraint. |
CommandBehavior |
Proporciona una descripción de los resultados de la consulta y su efecto en la base de datos. |
CommandType |
Especifica cómo se interpreta una cadena de comandos. |
ConflictOption |
Especifica cómo se van a detectar y resolver los cambios contradictorios del origen de datos. |
ConnectionState |
Describe el estado actual de la conexión a un origen de datos. |
DataRowAction |
Describe una acción realizada en un DataRow. |
DataRowState |
Obtiene el estado de un objeto DataRow. |
DataRowVersion |
Describe la versión de DataRow. |
DataSetDateTime |
Describe el formato de serialización para las columnas DateTime de un objeto DataSet. |
DataViewRowState |
Describe la versión de datos de un DataRow. |
DbType |
Especifica el tipo de datos de un campo, una propiedad o un objeto |
EntityState |
Estado de un objeto entidad. |
IsolationLevel |
Especifica el comportamiento de bloqueo de transacción para la conexión. |
KeyRestrictionBehavior |
Identifica la lista de parámetros de cadena de conexión especificados por la propiedad |
LoadOption |
Controla cómo los valores del origen de datos se aplicarán a las filas existentes al utilizar los métodos Load o Load. |
MappingType |
Especifica cómo se asigna DataColumn. |
MissingMappingAction |
Determina la acción que se produce cuando falta una asignación en una tabla de origen o una columna de origen. |
MissingSchemaAction |
Especifica la acción que se debe realizar cuando se agregan datos al DataSet y faltan el DataTable o DataColumn necesarios. |
ParameterDirection |
Especifica el tipo de un parámetro dentro de una consulta relativa al DataSet. |
PropertyAttributes |
Especifica los atributos de una propiedad. |
Rule |
Indica la acción que se produce cuando se fuerza ForeignKeyConstraint. |
SchemaSerializationMode |
Indica el modo de serialización del esquema de un objeto DataSet con tipo. |
SchemaType |
Especifica cómo controlar las asignaciones de esquema existentes al realizar una operación FillSchema(DataSet, SchemaType). |
SerializationFormat |
Determina el formato de serialización para un objeto DataSet. |
SqlDbType |
Especifica el tipo de datos específico de SQL Server de un campo o una propiedad para su uso en SqlParameter. |
StatementType |
Especifica el tipo de consulta SQL que utilizarán las clases OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs o SqlRowUpdatingEventArgs. |
UpdateRowSource |
Especifica cómo se aplican los resultados del comando de consulta a la fila que se actualiza. |
UpdateStatus |
Especifica la acción que se debe realizar sobre las filas actuales y pendientes mientras opera Update(DataSet). |
XmlReadMode |
Especifica cómo leer datos XML y un esquema relacional en un DataSet. |
XmlWriteMode |
Especifica cómo escribir datos XML y un esquema relacional a partir de un DataSet. |
Delegados
DataColumnChangeEventHandler |
Representa el método que controlará el evento ColumnChanging. |
DataRowChangeEventHandler |
Representa el método que controlará los eventos RowChanging, RowChanged, RowDeleting y RowDeleted de DataTable. |
DataTableClearEventHandler |
Representa el método que controla el método Clear(). |
DataTableNewRowEventHandler |
Representa el método que controla el método NewRow(). |
FillErrorEventHandler |
Representa el método que controlará el evento FillError. |
MergeFailedEventHandler |
Representa el método que controlará el evento MergeFailed. |
StateChangeEventHandler |
Representa el método que controlará el evento StateChange. |
StatementCompletedEventHandler |
El tipo de delegado para los controladores de eventos del evento StatementCompleted. |
Comentarios
En una situación sin conexión como Internet, ADO.NET proporciona las herramientas necesarias para solicitar, actualizar y reconciliar datos en varios sistemas de nivel. La arquitectura de ADO.NET también se implementa en aplicaciones cliente, como aplicaciones de Windows Forms, o en páginas HTML creadas por ASP.NET.
La base de la arquitectura de ADO.NET es la clase DataSet. Cada DataSet puede contener varios objetos DataTable, conteniendo cada DataTable datos de un origen de datos único, como SQL Server.
Cada DataTable contiene una DataColumnCollection (colección de objetos DataColumn), que determina el esquema de cada DataTable. La propiedad DataType determina el tipo de los datos contenidos en DataColumn. Las propiedades ReadOnly y AllowDBNull permiten garantizar aún más la integridad de datos. La propiedad Expression permite crear columnas calculadas.
Si un objeto DataTable participa en una relación de elementos primarios y secundarios con otro objeto DataTable, la relación se crea agregando DataRelation a la colección DataRelationCollection de un objeto DataSet. Cuando se agrega una relación de este tipo, se crean automáticamente una restricción UniqueConstraint y una restricción ForeignKeyConstraint, dependiendo de los valores de parámetros del constructor. UniqueConstraint garantiza que los valores contenidos en una columna son únicos. ForeignKeyConstraint determina la acción que se producirá en la columna o fila secundaria cuando se cambie o elimine un valor de clave principal.
Si se usa el espacio de nombres System.Data.SqlClient (Proveedor de datos .NET Framework para SQL Server), el espacio de nombres System.Data.Odbc (Proveedor de datos .NET Framework para ODBC), el espacio de nombres System.Data.OleDb (Proveedor de datos .NET Framework para OLE DB) o el espacio de nombres System.Data.OracleClient (Proveedor de datos .NET Framework para Oracle), se puede tener acceso a un origen de datos para utilizarlo con DataSet. Each.NET proveedor de datos de Framework tiene un dataAdapter correspondiente que se usa como puente entre un origen de datos y un DataSet.