System.Data Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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à |
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.