System.Data Espacio de nombres

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 DataRowBuilder admite la infraestructura de .NET y no está diseñado para usarse directamente desde el código.

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 EntityClient. La clase EntityException es la clase base de todas las excepciones de Entity Framework iniciadas por la clase EntityClient.

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 DataRow de origen y de destino tienen el mismo valor de clave principal, y la propiedad EnforceConstraints se establece en true.

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 false.

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 DBNull.

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 DataReader y se implementa mediante proveedores de datos de .NET que acceden a bases de datos relacionales.

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 Parameter de un proveedor de datos de .NET.

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 KeyRestrictions que están permitidos o que no están permitidos.

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.