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í.
Proporciona acceso a las clases que representan la arquitectura de ADO.NET. ADO.NET permite crear componentes que administran de forma eficaz los datos de varios orígenes de datos.
Clases
| Nombre | Description |
|---|---|
| Constraint |
Representa una restricción que se puede aplicar en uno o varios DataColumn objetos. |
| ConstraintCollection |
Representa una colección de restricciones para .DataTable |
| ConstraintException |
Representa la excepción que se produce al intentar una acción que infringe una restricción. |
| DataColumn |
Representa el esquema de una columna de un DataTable. |
| DataColumnChangeEventArgs |
Proporciona datos para el evento ColumnChanging. |
| DataColumnCollection |
Representa una colección de DataColumn objetos para un DataTableobjeto . |
| DataException |
Representa la excepción que se produce cuando se generan errores mediante componentes de ADO.NET. |
| DataReaderExtensions |
Proporciona métodos de extensión para DbDataReader. |
| DataRelation |
Representa una relación primaria o secundaria entre dos DataTable objetos. |
| DataRelationCollection |
Representa la colección de DataRelation objetos para este DataSetobjeto . |
| DataRow |
Representa una fila de datos de un DataTableobjeto . |
| DataRowBuilder |
El |
| DataRowChangeEventArgs |
Proporciona datos para los RowChangedeventos , RowChanging, OnRowDeleting(DataRowChangeEventArgs)y OnRowDeleted(DataRowChangeEventArgs) . |
| DataRowCollection |
Representa una colección de filas de un DataTableobjeto . |
| DataRowComparer |
Devuelve una instancia singleton de la DataRowComparer<TRow> clase . |
| DataRowComparer<TRow> |
Compara dos DataRow objetos para la equivalencia mediante la comparación basada en valores. |
| DataRowExtensions |
Define los métodos de extensión para la DataRow clase . Se trata de una clase estática. |
| DataRowView |
Representa una vista personalizada de .DataRow |
| DataSet |
Representa una caché en memoria de datos. |
| DataSetSchemaImporterExtension |
Este miembro admite la infraestructura de .NET Framework y no está pensado para usarse directamente 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 Clear() método . |
| DataTableCollection |
Representa la colección de tablas de DataSet. |
| DataTableExtensions |
Define los métodos de extensión para la DataTable clase . DataTableExtensions es una clase estática. |
| DataTableNewRowEventArgs |
Proporciona datos para el NewRow() método . |
| 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 databindable, personalizada de para DataTable ordenar, filtrar, buscar, editar y navegar. DataView no almacena datos, sino que representa una vista conectada de su correspondienteDataTable. Los cambios en los DataViewdatos de afectarán a DataTable. Los cambios en los DataTabledatos de afectarán a todos los DataViewasociados. |
| DataViewManager |
Contiene un valor predeterminado DataViewSettingCollection para cada DataTable en un DataSet. |
| DataViewSetting |
Representa la configuración predeterminada para ApplyDefaultSort, , DataViewManagerRowFilter, RowStateFilter, Sorty Table para DataViews creado a partir de DataViewManager. |
| DataViewSettingCollection |
Contiene una colección de solo lectura de DataViewSetting objetos para cada DataTable en un DataSetobjeto . |
| DBConcurrencyException |
Excepción producida por durante DataAdapter 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 cuando se intenta realizar una acción en un DataRow objeto 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 adición en un DataSet objeto -related. |
| EntityCommandCompilationException |
Representa los errores que se producen durante la compilación del comando; cuando no se pudo generar un árbol de comandos para representar el texto del comando. |
| EntityCommandExecutionException |
Representa los errores que se producen cuando el proveedor de almacenamiento subyacente no pudo ejecutar el comando especificado. Esta excepción suele encapsular una excepción específica del proveedor. |
| EntityException |
Representa errores relacionados con Entity Framework que se producen en el |
| EntityKey |
Proporciona una referencia duradera a un objeto que es una instancia de un tipo de entidad. |
| EntityKeyMember |
Representa un par de nombre de clave y valor que forma parte de un EntityKey. |
| EntitySqlException |
Representa los errores que se producen al analizar el texto del comando Entity SQL. Esta excepción se produce cuando se infringen las reglas sintácticas o semánticas. |
| EnumerableRowCollection |
Representa una colección de DataRow objetos devueltos desde una consulta LINQ to DataSet. Esta API admite la infraestructura de .NET y no está pensada para usarse directamente desde el código. |
| EnumerableRowCollection<TRow> |
Representa una colección de DataRow objetos devueltos desde 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 Expression propiedad de .DataColumn |
| FillErrorEventArgs |
Proporciona datos para el FillError evento de .DbDataAdapter |
| ForeignKeyConstraint |
Representa una restricción de acción aplicada en un conjunto de columnas de una relación de clave principal o clave externa cuando se elimina o actualiza un valor o fila. |
| InRowChangingEventException |
Representa la excepción que se produce cuando se llama al EndEdit() método dentro del RowChanging evento . |
| 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. Esta excepción no se produce actualmente en ninguna parte de Entity Framework. |
| InvalidConstraintException |
Representa la excepción que se produce cuando se intenta crear o acceder a una relación incorrectamente. |
| InvalidExpressionException |
Representa la excepción que se produce al intentar agregar un DataColumn objeto que contiene un valor no válido Expression para .DataColumnCollection |
| MappingException |
Excepción que se produce cuando se produce un error en la asignación de solicitudes de servicio relacionadas. |
| MergeFailedEventArgs |
Se produce cuando un destino y |
| MetadataException |
Excepción que se produce cuando se produce un error en las solicitudes de servicio relacionadas con metadatos. |
| MissingPrimaryKeyException |
Representa la excepción que se produce al intentar acceder a una fila de una tabla que no tiene ninguna clave principal. |
| NoNullAllowedException |
Representa la excepción que se produce al intentar insertar un valor NULL en una columna donde AllowDBNull se establece 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 se produce una infracción de simultaneidad optimista. |
| OrderedEnumerableRowCollection<TRow> |
Representa una colección de objetos ordenados DataRow devueltos desde una consulta. |
| PropertyCollection |
Representa una colección de propiedades que se pueden agregar a DataColumn, DataSeto DataTable. |
| PropertyConstraintException |
Clase de excepción de restricción de propiedad. Tenga en cuenta que esta clase tiene el estado , por lo que si cambia incluso sus elementos internos, puede ser un cambio importante. |
| ProviderIncompatibleException |
Excepción que se produce cuando el proveedor de datos subyacente no es compatible con Entity Framework. |
| ReadOnlyException |
Representa la excepción que se produce al intentar cambiar el valor de una columna de solo lectura. |
| RowNotInTableException |
Representa la excepción que se produce cuando se intenta realizar una operación en un DataRow que no está en .DataTable |
| StateChangeEventArgs |
Proporciona datos para el evento de cambio de estado de un proveedor de datos de .NET. |
| StatementCompletedEventArgs |
Proporciona información adicional para el StatementCompleted evento. |
| StrongTypingException |
Excepción producida por un fuertemente tipado DataSet cuando el usuario accede a un |
| SyntaxErrorException |
Representa la excepción que se produce cuando la Expression propiedad de un DataColumn contiene un error de sintaxis. |
| TypedDataSetGenerator |
Se usa para crear un objeto fuertemente tipado DataSet. |
| TypedDataSetGeneratorException |
Excepción que se produce cuando se produce un conflicto de nombre al generar un objeto fuertemente tipado DataSet. |
| TypedTableBase<T> |
Este tipo se usa como una clase base para la generación de objetos tipadosDataTable por Visual Studio y la herramienta de .NET Framework de XSD.exe, y no está pensado para usarse directamente desde el código. |
| TypedTableBaseExtensions |
Contiene los métodos de extensión de la TypedTableBase<T> clase . |
| UniqueConstraint |
Representa una restricción en un conjunto de columnas en las que todos los valores deben ser únicos. |
| UpdateException |
Excepción que se produce cuando las modificaciones en las instancias de objeto no se pueden conservar en el origen de datos. |
| VersionNotFoundException |
Representa la excepción que se produce al intentar devolver una versión de que DataRow se ha eliminado. |
Interfaces
| Nombre | Description |
|---|---|
| IColumnMapping |
Asocia una columna de origen de datos a una DataSet columna y la implementa la DataColumnMapping clase , que los proveedores de datos de .NET usan en común. |
| IColumnMappingCollection |
Contiene una colección de objetos DataColumnMapping y se implementa mediante , DataColumnMappingCollectionque los proveedores de datos de .NET usan en común. |
| IDataAdapter |
Permite a un objeto implementar un DataAdapter y representa un conjunto de métodos y asignar propiedades relacionadas con acciones que se usan para rellenar y actualizar un DataSet origen de datos y actualizarlo. IDbDataAdapter Las instancias son para orígenes de datos que son bases de datos relacionales (o similares) con comandos textuales (como Transact-SQL), mientras que IDataAdapter las instancias pueden usar cualquier tipo de origen de datos. |
| IDataParameter |
Representa un parámetro para un objeto Command y, opcionalmente, su asignación a DataSet columnas; y lo implementan los proveedores de datos de .NET que acceden a los orígenes de datos. |
| IDataParameterCollection |
Recopila todos los parámetros pertinentes para un objeto Command y sus asignaciones a DataSet columnas, y los proveedores de datos de .NET que acceden a los orígenes de datos. |
| IDataReader |
Proporciona un medio para leer uno o varios flujos de resultados de solo avance obtenidos mediante la ejecución de un comando en un origen de datos y lo implementan los proveedores de datos de .NET que acceden a bases de datos relacionales. |
| IDataRecord |
Proporciona acceso a los valores de columna dentro de cada fila de un |
| IDbCommand |
Representa una instrucción SQL que se ejecuta mientras está conectada a un origen de datos y la implementan los proveedores de datos de .NET que acceden a bases de datos relacionales. |
| IDbConnection |
Representa una conexión abierta a un origen de datos y la implementan los proveedores de datos de .NET que acceden a bases de datos relacionales. |
| IDbDataAdapter |
Representa un conjunto de propiedades relacionadas con comandos que se usan para rellenar DataSet y actualizar un origen de datos y se implementa mediante proveedores de datos de .NET que acceden a bases de datos relacionales. |
| IDbDataParameter |
Usado por los diseñadores de datos de .NET de Visual Basic para representar un parámetro en un objeto Command y, opcionalmente, su asignación a DataSet columnas. |
| IDbTransaction |
Representa una transacción que se va a realizar en un origen de datos y la implementan los 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 para DbDataRecord un DbDataReader. |
| ITableMapping |
Asocia una tabla de origen a una tabla de DataSety la implementa la DataTableMapping clase , que los proveedores de datos de .NET usan en común. |
| ITableMappingCollection |
Contiene una colección de objetos TableMapping y se implementa mediante , DataTableMappingCollectionque los proveedores de datos de .NET usan en común. |
Enumeraciones
| Nombre | Description |
|---|---|
| AcceptRejectRule |
Determina la acción que se produce cuando se invoca el método 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 detectarán y resolverán los cambios en conflicto en el 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 un DataRow. |
| DataSetDateTime |
Describe el formato de serialización para DateTime columnas de un DataSet. |
| DataViewRowState |
Describe la versión de los datos de un DataRow. |
| DbType |
Especifica el tipo de datos de un campo, una propiedad o un objeto |
| EntityState |
Estado de un objeto de entidad. |
| IsolationLevel |
Especifica el comportamiento de bloqueo de transacciones para la conexión. |
| KeyRestrictionBehavior |
Identifica una lista de parámetros de cadena de conexión identificados por la propiedad |
| LoadOption |
Controla cómo se aplicarán los valores del origen de datos a las filas existentes al usar el método Load o Load. |
| MappingType |
Especifica cómo se asigna un DataColumn. |
| MissingMappingAction |
Determina la acción que se produce cuando falta una asignación de una tabla de origen o una columna de origen. |
| MissingSchemaAction |
Especifica la acción que se debe realizar al agregar datos a la DataSet y faltan los DataTable o DataColumn necesarios. |
| ParameterDirection |
Especifica el tipo de un parámetro dentro de una consulta en relación con el DataSet. |
| PropertyAttributes |
Especifica los atributos de una propiedad . |
| Rule |
Indica la acción que se produce cuando se aplica un ForeignKeyConstraint. |
| SchemaSerializationMode |
Indica el modo de serialización de esquema para un DataSetcon tipo . |
| SchemaType |
Especifica cómo controlar las asignaciones de esquema existentes al realizar una operación de FillSchema(DataSet, SchemaType). |
| SerializationFormat |
Determina el formato de serialización de un DataSet. |
| SqlDbType |
Especifica el tipo de datos específico de SQL Server de un campo, propiedad, para su uso en un SqlParameter. |
| StatementType |
Especifica el tipo de consulta SQL que va a usar la clase OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgso SqlRowUpdatingEventArgs. |
| UpdateRowSource |
Especifica cómo se aplican los resultados del comando de consulta a la fila que se está actualizando. |
| UpdateStatus |
Especifica la acción que se debe realizar con respecto a las filas actuales y restantes durante un 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 desde un DataSet. |
Delegados
| Nombre | Description |
|---|---|
| DataColumnChangeEventHandler |
Representa el método que controlará el ColumnChanging evento. |
| DataRowChangeEventHandler |
Representa el método que controlará los RowChangingeventos , RowChanged, RowDeletingy RowDeleted de .DataTable |
| DataTableClearEventHandler |
Representa el método que controla el Clear() método . |
| DataTableNewRowEventHandler |
Representa el método que controla el NewRow() método . |
| FillErrorEventHandler |
Representa el método que controlará el FillError evento. |
| MergeFailedEventHandler |
Representa el método que controlará el MergeFailed evento. |
| StateChangeEventHandler |
Representa el método que controlará el StateChange evento. |
| StatementCompletedEventHandler |
Tipo de delegado para los controladores de eventos del StatementCompleted evento. |
Comentarios
En un escenario desconectado como Internet, ADO.NET proporciona las herramientas para solicitar, actualizar y conciliar datos en varios sistemas de niveles. La arquitectura de ADO.NET también se implementa en aplicaciones cliente, como Windows Forms o páginas HTML creadas por ASP.NET.
La pieza central de la arquitectura ADO.NET es la DataSet clase . Cada DataSet uno puede contener varios DataTable objetos, con cada uno DataTable que contenga datos de un único origen de datos, como SQL Server.
Cada DataTable contiene una DataColumnCollectioncolección de DataColumn objetos ,que determina el esquema de cada DataTable. La DataType propiedad determina el tipo de datos mantenidos por .DataColumn Las ReadOnly propiedades y AllowDBNull permiten garantizar aún más la integridad de los datos. La Expression propiedad permite construir columnas calculadas.
Si participa DataTable en una relación primaria o secundaria con otra DataTable, la relación se construye agregando un DataRelation elemento al DataRelationCollection de un DataSet objeto . Cuando se agrega dicha relación, se crea y UniqueConstraintForeignKeyConstraint se crean automáticamente, en función de la configuración de parámetros del constructor. Garantiza UniqueConstraint que los valores contenidos en una columna sean únicos. ForeignKeyConstraint determina qué acción ocurrirá con la fila o columna secundaria cuando se cambia o elimina un valor de clave principal.
Con el System.Data.SqlClient espacio de nombres (the.NET Proveedor de datos framework para SQL Server), el System.Data.Odbc espacio de nombres (the.NET Proveedor de datos framework para ODBC), el System.Data.OleDb espacio de nombres (the.NET Proveedor de datos framework para OLE DB) o el System.Data.OracleClient espacio de nombres (el proveedor de datos de .NET Framework para Oracle), puede tener acceso a un origen de datos para usarlo junto 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.