System.Data Spazio dei nomi

Fornisce accesso alle classi che rappresentano l'architettura ADO.NET. ADO.NET consente di compilare componenti che permettono di gestire in modo efficace i dati di più origini dati.

Classi

Constraint

Rappresenta un vincolo che può essere applicato a uno o più oggetti DataColumn.

ConstraintCollection

Rappresenta un insieme di vincoli per un oggetto DataTable.

ConstraintException

Rappresenta l'eccezione generata durante il tentativo di esecuzione di un'azione che viola un vincolo.

DataColumn

Rappresenta lo schema di una colonna di una DataTable.

DataColumnChangeEventArgs

Fornisce dati per l'evento ColumnChanging.

DataColumnCollection

Rappresenta un insieme di oggetti DataColumn di un oggetto DataTable.

DataException

Rappresenta l'eccezione generata quando vengono generati degli errori dall'impiego di componenti ADO.NET.

DataReaderExtensions

Fornisce metodi di estensione per DbDataReader.

DataRelation

Rappresenta una relazione padre/figlio tra due oggetti DataTable.

DataRelationCollection

Rappresenta l'insieme di oggetti DataRelation dell'oggetto DataSet.

DataRow

Rappresenta una riga di dati in un oggetto DataTable.

DataRowBuilder

Il tipo DataRowBuilder supporta l'infrastruttura .NET e non può essere usato direttamente dal codice.

DataRowChangeEventArgs

Fornisce dati per gli eventi RowChanged, RowChanging, OnRowDeleting(DataRowChangeEventArgs) e OnRowDeleted(DataRowChangeEventArgs).

DataRowCollection

Rappresenta un insieme di righe per un oggetto DataTable.

DataRowComparer

Restituisce un’istanza singleton della classe DataRowComparer<TRow>.

DataRowComparer<TRow>

Confronta due oggetti DataRow per verificarne l'equivalenza utilizzando il confronto basato su valore.

DataRowExtensions

Definisce i metodi di estensione per la classe DataRow. Si tratta di una classe statica.

DataRowView

Rappresenta una visualizzazione personalizzata di un oggetto DataRow.

DataSet

Rappresenta una cache in memoria dei dati.

DataSetSchemaImporterExtension

Questo membro supporta l'infrastruttura .NET Framework e non è possibile usarlo direttamente dal codice.

DataSysDescriptionAttribute

Applica una descrizione a una proprietà, un evento o un'estensione. Questa descrizione può essere visualizzata nelle finestre di progettazione visiva quando si fa riferimento al membro.

DataTable

Rappresenta una tabella di dati in memoria.

DataTableClearEventArgs

Fornisce i dati per il metodo Clear().

DataTableCollection

Rappresenta l'insieme di tabelle per l'oggetto DataSet.

DataTableExtensions

Definisce i metodi di estensione per la classe DataTable. DataTableExtensions è una classe statica.

DataTableNewRowEventArgs

Fornisce i dati per il metodo NewRow().

DataTableReader

Il tipo DataTableReader presenta il contenuto di uno o più oggetti DataTable sotto forma di uno o più set di risultati forward-only di sola lettura.

DataView

Rappresenta una visualizzazione personalizzata e disponibile per il data binding di un oggetto DataTable per l'ordinamento, il filtraggio, la ricerca, la modifica e l'esplorazione. L'oggetto DataView non memorizza dati ma rappresenta una visualizzazione connessa dell'oggetto DataTable corrispondente. Le modifiche ai dati dell'oggetto DataView influiscono sull'oggetto DataTable. Le modifiche ai dati dell'oggetto DataTable influiscono su tutti gli oggetti DataView associati ad esso.

DataViewManager

Contiene un DataViewSettingCollection predefinito per ogni DataTable in un DataSet.

DataViewSetting

Rappresenta le impostazioni predefinite per le proprietà ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort e Table degli oggetti DataView creati dalla classe DataViewManager.

DataViewSettingCollection

Contiene un insieme in sola lettura di oggetti DataViewSetting per ciascun oggetto DataTable in un oggetto DataSet.

DBConcurrencyException

Eccezione generata dalla classe DataAdapter durante un'operazione di inserimento, aggiornamento o eliminazione, se il numero di righe interessate è uguale a zero.

DeletedRowInaccessibleException

Rappresenta l'eccezione generata durante il tentativo di eseguire un'azione su una classe DataRow eliminata.

DuplicateNameException

Rappresenta l'eccezione generata quando viene rilevato il nome di un oggetto di database duplicato durante un'operazione di aggiunta in un oggetto relativo al DataSet.

EntityCommandCompilationException

Rappresenta gli errori che si verificano durante la compilazione del comando, quando non è possibile produrre un albero dei comandi per rappresentare il testo del comando.

EntityCommandExecutionException

Rappresenta gli errori che si verificano quando non è possibile l'esecuzione del comando specificato da parte del provider di archiviazione sottostante. Questa eccezione esegue in genere il wrapping di un'eccezione specifica del provider.

EntityException

Rappresenta gli errori correlati a Entity Framework che si verificano nello spazio dei nomi EntityClient. EntityException è la classe base di tutte le eccezioni relative a Entity Framework generate da EntityClient.

EntityKey

Fornisce un riferimento durevole a un oggetto che rappresenta un'istanza di un tipo di entità.

EntityKeyMember

Rappresenta la coppia nome/valore della chiave di un oggetto EntityKey.

EntitySqlException

Rappresenta gli errori che si verificano durante l'analisi del testo del comando Entity SQL. Questa eccezione viene generata in caso di violazione delle regole sintattiche o semantiche.

EnumerableRowCollection

Rappresenta una raccolta di oggetti DataRow restituiti da una query LINQ to DataSet. Questa API supporta l'infrastruttura .NET e non può essere usata direttamente dal codice.

EnumerableRowCollection<TRow>

Rappresenta un insieme di oggetti DataRow restituiti da una query.

EnumerableRowCollectionExtensions

Contiene i metodi di estensione per le classi di insiemi della riga di dati.

EvaluateException

Rappresenta l'eccezione generata quando non è possibile valutare la proprietà Expression di un oggetto DataColumn.

FillErrorEventArgs

Fornisce i dati per l'evento FillError di una classeDbDataAdapter.

ForeignKeyConstraint

Rappresenta una restrizione di azione applicata su un insieme di colonne in una relazione chiave primaria/chiave esterna quando si aggiorna o si elimina un valore o una riga.

InRowChangingEventException

Rappresenta l'eccezione generata quando si chiama il metodo EndEdit() all'interno dell'evento RowChanging.

InternalDataCollectionBase

Fornisce la funzionalità base per la creazione di insiemi.

InvalidCommandTreeException

Eccezione generata per indicare che una struttura ad albero dei comandi non è valida. Questa eccezione non viene al momento generata in qualsiasi posizione in Entity Framework.

InvalidConstraintException

Rappresenta l'eccezione generata quando si tenta di creare o di accedere a una relazione in modo non corretto.

InvalidExpressionException

Rappresenta l'eccezione generata quando si tenta di aggiungere una classe DataColumn, contenente una proprietà Expression non valida, a una classe DataColumnCollection.

MappingException

Eccezione generata in caso di errore delle richieste di servizio correlate al mapping.

MergeFailedEventArgs

Viene generata quando l'oggetto DataRow di origine e di destinazione presentano la stessa chiave primaria e la proprietà EnforceConstraints è impostata su True.

MetadataException

Eccezione generata in caso di errore delle richieste di servizio correlate ai metadati.

MissingPrimaryKeyException

Rappresenta l'eccezione generata quando si verifica un tentativo di accesso a una riga di una tabella priva di chiave primaria.

NoNullAllowedException

Rappresenta l'eccezione generata quando si prova a inserire un valore null in una colonna nella quale la proprietà AllowDBNull è impostata su false.

ObjectNotFoundException

Eccezione generata quando un oggetto non è presente.

OperationAbortedException

Questa eccezione viene generata quando un'operazione in corso viene interrotta dall'utente.

OptimisticConcurrencyException

Eccezione generata quando si verifica una violazione della concorrenza ottimistica.

OrderedEnumerableRowCollection<TRow>

Rappresenta una raccolta di oggetti DataRow ordinati restituiti da una query.

PropertyCollection

Rappresenta un insieme di proprietà che è possibile aggiungere a un oggetto DataColumn, DataSet o DataTable.

PropertyConstraintException

Classe di eccezione del vincolo della proprietà. Si noti che questa classe dispone di uno stato, pertanto se si modificano anche gli elementi interni, la modifica potrebbe essere sostanziale.

ProviderIncompatibleException

Eccezione generata quando il provider di dati sottostante non è compatibile con Entity Framework.

ReadOnlyException

Rappresenta l'eccezione generata durante il tentativo di modificare il valore di una colonna in sola lettura.

RowNotInTableException

Rappresenta l'eccezione generata durante il tentativo di esecuzione di un'azione su una classe DataRow non contenuta in una classe DataTable.

StateChangeEventArgs

Specifica i dati per l'evento di modifica stato di un provider di dati .NET.

StatementCompletedEventArgs

Fornisce informazioni aggiuntive sull'evento StatementCompleted.

StrongTypingException

Eccezione generata da un oggetto DataSet fortemente tipizzato quando l'utente accede a un valore DBNull.

SyntaxErrorException

Rappresenta l'eccezione generata quando nella proprietà Expression di un oggetto DataColumn è presente un errore di sintassi.

TypedDataSetGenerator

Utilizzata per creare un oggetto DataSet fortemente tipizzato.

TypedDataSetGeneratorException

Eccezione generata quando si verifica un conflitto tra nomi durante la generazione di un oggetto DataSet fortemente tipizzato.

TypedTableBase<T>

Questo tipo viene usato come classe di base per la generazione di oggetti DataTable tipizzati tramite Visual Studio e lo strumento .NET Framework XSD.exe e non può essere usato direttamente dal codice.

TypedTableBaseExtensions

Contiene i metodi di estensione per la classe TypedTableBase<T>.

UniqueConstraint

Rappresenta una restrizione su un insieme di colonne in cui è necessario che tutti i valori siano univoci.

UpdateException

Eccezione generata quando non è possibile rendere persistenti le modifiche alle istanze degli oggetti nell'origine dati.

VersionNotFoundException

Rappresenta l'eccezione generata quando si tenta di restituire una versione di una classe DataRow eliminata.

Interfacce

IColumnMapping

Consente di associare una colonna di un'origine dati a una colonna di un oggetto DataSet e viene implementata dalla classe DataColumnMapping, usata in comune dai provider di dati .NET.

IColumnMappingCollection

Consente di contenere un insieme di oggetti DataColumnMapping e viene implementata dalla classe DataColumnMappingCollection, usata in comune dai provider di dati .NET.

IDataAdapter

Consente a un oggetto di implementare un oggetto DataAdapter e rappresenta un insieme di metodi e proprietà correlate ad azioni di mapping utilizzate per riempire e aggiornare DataSet e aggiornare un'origine dati.

Le istanze di IDbDataAdapter sono per le origini dati che sono o sembrano database relazionali con comandi testuali (come Transact-SQL), mentre le istanze di IDataAdapter possono usare qualsiasi tipo di origine dati.

IDataParameter

Rappresenta un parametro per un oggetto Command ed eventualmente il relativo mapping a colonne DataSet e viene implementata dai provider di dati .NET che accedono a database relazionali.

IDataParameterCollection

Raccoglie tutti i parametri relativi a un oggetto Command e i relativi mapping a colonne DataSet e viene implementata dai provider di dati .NET che accedono a database relazionali.

IDataReader

Consente di leggere uno o più flussi forward-only di set di risultati ottenuti eseguendo un comando in corrispondenza di un'origine dati e viene implementata dai provider di dati .NET che accedono a database relazionali.

IDataRecord

Consente l'accesso ai valori di colonna all'interno di ogni riga per un DataReader e viene implementata dai provider di dati .NET che accedono a database relazionali.

IDbCommand

Rappresenta un'istruzione SQL eseguita durante la connessione a un'origine dati e viene implementata dai provider di dati .NET che accedono ai database relazionali.

IDbConnection

Rappresenta una connessione aperta a un'origine dati e viene implementata dai provider di dati .NET che accedono ai database relazionali.

IDbDataAdapter

Rappresenta un insieme di proprietà relative ai comandi che vengono usate per compilare l'oggetto DataSet e aggiornare un'origine dati e viene implementata dai provider di dati .NET con accesso ai database relazionali.

IDbDataParameter

Usata da Data Designer di Visual Basic .NET per rappresentare un parametro di un oggetto Command e, facoltativamente, il relativo mapping alle colonne dell'oggetto DataSet.

IDbTransaction

Rappresenta una transazione da eseguire in un'origine dati e viene implementata dai provider di dati .NET che accedono ai database relazionali.

IExtendedDataRecord

Fornisce l'accesso ai valori delle colonne in ogni riga di DbDataRecord per un oggetto DbDataReader.

ITableMapping

Associa una tabella di origine a una tabella di un oggetto DataSet e viene implementata dalla classe DataTableMapping usata in comune dai provider di dati .NET.

ITableMappingCollection

Contiene un insieme di oggetti TableMapping e viene implementata dalla classe DataTableMappingCollection, usata in comune dai provider di dati .NET.

Enumerazioni

AcceptRejectRule

Determina l'azione eseguita quando viene chiamato il metodo AcceptChanges() o il metodo RejectChanges() su un oggetto DataTable con un vincolo ForeignKeyConstraint.

CommandBehavior

Fornisce una descrizione dei risultati della query e dei relativi effetti sul database.

CommandType

Specifica il modo in cui viene interpretata una stringa di comando.

ConflictOption

Specifica il modo in cui vengono rilevate e risolte le modifiche in conflitto apportate all'origine dati.

ConnectionState

Descrive lo stato corrente della connessione a un'origine dati.

DataRowAction

Descrive un'azione eseguita su un oggetto DataRow.

DataRowState

Ottiene lo stato di un oggetto DataRow.

DataRowVersion

Descrive la versione di un oggetto DataRow.

DataSetDateTime

Descrive il formato di serializzazione per le colonne DateTime in una classe DataSet.

DataViewRowState

Descrive la versione dei dati in un oggetto DataRow.

DbType

Specifica il tipo di dati di un campo, di una proprietà o di un oggetto Parameter di un provider di dati .NET.

EntityState

Stato di un oggetto entità.

IsolationLevel

Specifica il comportamento di blocco della transazione per la connessione.

KeyRestrictionBehavior

Identifica un elenco di parametri di stringa di connessione consentiti o non consentiti, identificati dalla proprietà KeyRestrictions.

LoadOption

Controlla la modalità di applicazione dei valori dell'origine dati alle righe esistenti quando viene utilizzato il metodo Load o Load.

MappingType

Specifica la modalità di esecuzione del mapping di un oggetto DataColumn.

MissingMappingAction

Determina l'azione che si verifica quando manca il mapping di una tabella o di una colonna di origine.

MissingSchemaAction

Specifica l'azione da eseguire quando si aggiungono dati all'oggetto DataSet e risultano mancanti gli oggetti DataTable o DataColumn necessari.

ParameterDirection

Specifica il tipo di un parametro contenuto in una query relativa all'oggetto DataSet.

PropertyAttributes

Specifica gli attributi di una proprietà.

Rule

Indica l'azione che si verifica quando viene applicato un ForeignKeyConstraint.

SchemaSerializationMode

Indica la modalità di serializzazione dello schema per una classe DataSet tipizzata.

SchemaType

Specifica come gestire i mapping dello schema esistenti quando si esegue un'operazione FillSchema(DataSet, SchemaType).

SerializationFormat

Stabilisce il formato di serializzazione per una classe DataSet.

SqlDbType

Specifica il tipo di dati specifici di SQL Server di un campo o di una proprietà da utilizzare in un oggetto SqlParameter.

StatementType

Specifica il tipo di query SQL che deve essere utilizzata dalle classi OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs o SqlRowUpdatingEventArgs.

UpdateRowSource

Specifica il modo in cui vengono applicati i risultati dei comandi di query alla riga da aggiornare.

UpdateStatus

Specifica l'azione da effettuare in relazione alle righe correnti e rimanenti durante un'operazione Update(DataSet).

XmlReadMode

Specifica come leggere i dati XML e uno schema relazionale in un oggetto DataSet.

XmlWriteMode

Specifica come scrivere i dati XML e uno schema relazionale da un oggetto DataSet.

Delegati

DataColumnChangeEventHandler

Rappresenta il metodo che gestirà l'evento ColumnChanging.

DataRowChangeEventHandler

Rappresenta il metodo che gestirà gli eventi RowChanging, RowChanged, RowDeleting e RowDeleted di un oggetto DataTable.

DataTableClearEventHandler

Rappresenta il metodo che gestisce il metodo Clear().

DataTableNewRowEventHandler

Rappresenta il metodo che gestisce il metodo NewRow().

FillErrorEventHandler

Rappresenta il metodo che gestirà l'evento FillError.

MergeFailedEventHandler

Rappresenta il metodo che gestirà l'evento MergeFailed.

StateChangeEventHandler

Rappresenta il metodo che gestirà l'evento StateChange.

StatementCompletedEventHandler

Il tipo delegato per i gestori eventi dell'evento StatementCompleted.

Commenti

In uno scenario disconnesso, ad esempio Internet, ADO.NET fornisce gli strumenti per richiedere e aggiornare i dati, nonché per risolvere le differenze, in sistemi a più livelli. L'architettura ADO.NET è implementata anche nelle applicazioni client, ad esempio Windows Form o pagine HTML create da ASP.NET.

L'elemento centrale dell'architettura ADO.NET è costituito dalla classe DataSet. Ogni oggetto DataSet può contenere più oggetti DataTable, con ogni oggetto DataTable che contiene i dati di una singola origine dati, ad esempio SQL Server.

Ogni oggetto DataTable contiene un oggetto DataColumnCollection, ovvero una raccolta di oggetti DataColumn, che determina lo schema di ogni oggetto DataTable. La proprietà DataType consente di determinare il tipo di dati inclusi in DataColumn. Le proprietà ReadOnly e AllowDBNull consentono di garantire ulteriormente l'integrità dei dati. La proprietà Expression consente di costruire colonne calcolate.

Se un oggetto DataTable partecipa in una relazione padre/figlio con un altro oggetto DataTable, la relazione viene costruita aggiungendo un oggetto DataRelation a DataRelationCollection di un oggetto DataSet. Quando tale relazione viene aggiunta, vengono creati automaticamente un oggetto UniqueConstraint e un oggetto ForeignKeyConstraint, a seconda delle impostazioni dei parametri per il costruttore. UniqueConstraint garantisce l'univocità dei valori inclusi in una colonna. ForeignKeyConstraint determina l'azione eseguita su una colonna o su una riga figlio quando un valore di chiave primaria viene modificato o eliminato.

Utilizzando lo spazio dei nomi System.Data.SqlClient (provider di dati .NET Framework per SQL Server), lo spazio dei nomi System.Data.Odbc (provider di dati .NET Framework per ODBC), lo spazio dei nomi System.Data.OleDb (provider di dati .NET Framework per OLE DB) o lo spazio dei nomi System.Data.OracleClient (provider di dati .NET Framework per Oracle), è possibile accedere a un'origine dati da utilizzare con un oggetto DataSet. Each.NET Framework il provider di dati dispone di un DataAdapter corrispondente usato come bridge tra un'origine dati e un oggetto DataSet.