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 l'accesso alle classi che rappresentano l'architettura ADO.NET. ADO.NET consente di creare componenti che gestiscono in modo efficiente i dati da più origini dati.
Classi
| Nome | Descrizione |
|---|---|
| Constraint |
Rappresenta un vincolo che può essere applicato a uno o più DataColumn oggetti. |
| ConstraintCollection |
Rappresenta una raccolta di vincoli per un oggetto DataTable. |
| ConstraintException |
Rappresenta l'eccezione generata durante il tentativo di un'azione che viola un vincolo. |
| DataColumn |
Rappresenta lo schema di una colonna in un oggetto DataTable. |
| DataColumnChangeEventArgs |
Fornisce i dati per l'evento ColumnChanging. |
| DataColumnCollection |
Rappresenta una raccolta di DataColumn oggetti per un oggetto DataTable. |
| DataException |
Rappresenta l'eccezione generata quando vengono generati errori utilizzando componenti ADO.NET. |
| DataReaderExtensions |
Fornisce metodi di estensione per DbDataReader. |
| DataRelation |
Rappresenta una relazione padre/figlio tra due DataTable oggetti. |
| DataRelationCollection |
Rappresenta la raccolta di DataRelation oggetti per l'oggetto DataSet. |
| DataRow |
Rappresenta una riga di dati in un oggetto DataTable. |
| DataRowBuilder |
Il |
| DataRowChangeEventArgs |
Fornisce i dati per gli RowChangedeventi , RowChangingOnRowDeleting(DataRowChangeEventArgs), e OnRowDeleted(DataRowChangeEventArgs) . |
| DataRowCollection |
Rappresenta una raccolta di righe per un oggetto DataTable. |
| DataRowComparer |
Restituisce un'istanza singleton della DataRowComparer<TRow> classe . |
| DataRowComparer<TRow> |
Confronta due DataRow oggetti per ottenere l'equivalenza usando il confronto basato su valori. |
| DataRowExtensions |
Definisce i metodi di estensione per la DataRow classe . 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 deve essere usato direttamente dal codice. |
| DataSysDescriptionAttribute |
Contrassegna una proprietà, un evento o un extender con una descrizione. Le finestre di progettazione degli oggetti visivi possono visualizzare questa descrizione quando si fa riferimento al membro. |
| DataTable |
Rappresenta una tabella di dati in memoria. |
| DataTableClearEventArgs |
Fornisce i dati per il Clear() metodo . |
| DataTableCollection |
Rappresenta l'insieme di tabelle per l'oggetto DataSet. |
| DataTableExtensions |
Definisce i metodi di estensione per la DataTable classe . DataTableExtensions è una classe statica. |
| DataTableNewRowEventArgs |
Fornisce i dati per il NewRow() metodo . |
| DataTableReader |
DataTableReader Ottiene il contenuto di uno o più oggetti sotto forma di uno o più DataTable set di risultati forward-only di sola lettura. |
| DataView |
Rappresenta una vista databindable, personalizzata di un DataTable oggetto per l'ordinamento, il filtro, la ricerca, la modifica e la navigazione. Non DataView archivia i dati, ma rappresenta invece una visualizzazione connessa del corrispondente DataTableoggetto . Le modifiche apportate ai DataViewdati di influiranno sull'oggetto DataTable. Le modifiche apportate ai DataTabledati dell'oggetto influiscono su tutti i DataViewdati associati. |
| DataViewManager |
Contiene un valore predefinito DataViewSettingCollection per ognuno DataTable di essi in un oggetto DataSet. |
| DataViewSetting |
Rappresenta le impostazioni predefinite per ApplyDefaultSort, RowFilterDataViewManager, RowStateFilter, , Sorte Table per DataViews create da DataViewManager. |
| DataViewSettingCollection |
Contiene una raccolta di sola lettura di DataViewSetting oggetti per ognuno DataTable di un oggetto DataSet. |
| DBConcurrencyException |
Eccezione generata da DataAdapter durante un'operazione di inserimento, aggiornamento o eliminazione se il numero di righe interessate è uguale a zero. |
| DeletedRowInaccessibleException |
Rappresenta l'eccezione generata quando viene tentata un'azione su un DataRow oggetto eliminato. |
| DuplicateNameException |
Rappresenta l'eccezione generata quando viene rilevato un nome di oggetto di database duplicato durante un'operazione di aggiunta in un DataSet oggetto -related. |
| EntityCommandCompilationException |
Rappresenta gli errori che si verificano durante la compilazione dei comandi; quando non è stato possibile produrre un albero dei comandi per rappresentare il testo del comando. |
| EntityCommandExecutionException |
Rappresenta gli errori che si verificano quando il provider di archiviazione sottostante non è riuscito a eseguire il comando specificato. Questa eccezione in genere esegue il wrapping di un'eccezione specifica del provider. |
| EntityException |
Rappresenta gli errori correlati a Entity Framework che si verificano nello spazio dei |
| EntityKey |
Fornisce un riferimento durevole a un oggetto che è un'istanza di un tipo di entità. |
| EntityKeyMember |
Rappresenta un nome di chiave e una coppia di valori che fa parte di un oggetto EntityKey. |
| EntitySqlException |
Rappresenta gli errori che si verificano durante l'analisi del testo del comando Entity SQL. Questa eccezione viene generata quando vengono violate regole sintattiche o semantiche. |
| EnumerableRowCollection |
Rappresenta una raccolta di DataRow oggetti restituiti da una query LINQ to DataSet. Questa API supporta l'infrastruttura .NET e non deve essere usata direttamente dal codice. |
| EnumerableRowCollection<TRow> |
Rappresenta una raccolta di DataRow oggetti restituiti da una query. |
| EnumerableRowCollectionExtensions |
Contiene i metodi di estensione per le classi di raccolta di righe di dati. |
| EvaluateException |
Rappresenta l'eccezione generata quando la Expression proprietà di un DataColumn oggetto non può essere valutata. |
| FillErrorEventArgs |
Fornisce i dati per l'evento FillError di un oggetto DbDataAdapter. |
| ForeignKeyConstraint |
Rappresenta una restrizione dell'azione applicata a un set di colonne in una relazione chiave primaria/chiave esterna quando un valore o una riga viene eliminato o aggiornato. |
| InRowChangingEventException |
Rappresenta l'eccezione generata quando si chiama il EndEdit() metodo all'interno dell'evento RowChanging . |
| InternalDataCollectionBase |
Fornisce la funzionalità di base per la creazione di raccolte. |
| InvalidCommandTreeException |
Eccezione generata per indicare che un albero dei comandi non è valido. Questa eccezione non viene attualmente generata in alcun punto di Entity Framework. |
| InvalidConstraintException |
Rappresenta l'eccezione generata quando si tenta erroneamente di creare o accedere a una relazione. |
| InvalidExpressionException |
Rappresenta l'eccezione generata quando si tenta di aggiungere un oggetto contenente un DataColumn oggetto non valido Expression a un oggetto DataColumnCollection. |
| MappingException |
Eccezione generata quando il mapping delle richieste di servizio correlate ha esito negativo. |
| MergeFailedEventArgs |
Si verifica quando una destinazione e un'origine |
| MetadataException |
Eccezione generata quando le richieste di servizio correlate ai metadati hanno esito negativo. |
| MissingPrimaryKeyException |
Rappresenta l'eccezione generata quando si tenta di accedere a una riga in una tabella senza chiave primaria. |
| NoNullAllowedException |
Rappresenta l'eccezione generata quando si tenta di inserire un valore Null in una colonna in cui AllowDBNull è impostato 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 ordinati DataRow restituiti da una query. |
| PropertyCollection |
Rappresenta una raccolta di proprietà che possono essere aggiunte a DataColumn, DataSeto DataTable. |
| PropertyConstraintException |
Classe di eccezione del vincolo di proprietà. Si noti che questa classe ha lo stato, quindi se si modificano anche i relativi elementi interni, può essere una modifica che causa un'interruzione. |
| ProviderIncompatibleException |
Eccezione generata quando il provider di dati sottostante non è compatibile con Entity Framework. |
| ReadOnlyException |
Rappresenta l'eccezione generata quando si tenta di modificare il valore di una colonna di sola lettura. |
| RowNotInTableException |
Rappresenta l'eccezione generata quando si tenta di eseguire un'operazione su un DataRow oggetto che non si trova in un oggetto DataTable. |
| StateChangeEventArgs |
Fornisce dati per l'evento di modifica dello stato di un provider di dati .NET. |
| StatementCompletedEventArgs |
Fornisce informazioni aggiuntive per l'evento StatementCompleted . |
| StrongTypingException |
Eccezione generata da un oggetto fortemente tipizzato DataSet quando l'utente accede a un |
| SyntaxErrorException |
Rappresenta l'eccezione generata quando la Expression proprietà di un DataColumn oggetto contiene un errore di sintassi. |
| TypedDataSetGenerator |
Usato per creare un oggetto fortemente tipizzato DataSet. |
| TypedDataSetGeneratorException |
Eccezione generata quando si verifica un conflitto di nomi durante la generazione di un oggetto fortemente tipizzato DataSet. |
| TypedTableBase<T> |
Questo tipo viene usato come classe di base per la generazione di oggetti tipizzataDataTable da Visual Studio e lo strumento XSD.exe .NET Framework e non deve essere usato direttamente dal codice. |
| TypedTableBaseExtensions |
Contiene i metodi di estensione per la TypedTableBase<T> classe . |
| UniqueConstraint |
Rappresenta una restrizione per un set di colonne in cui tutti i valori devono essere univoci. |
| UpdateException |
Eccezione generata quando non è possibile rendere persistenti le modifiche alle istanze dell'oggetto nell'origine dati. |
| VersionNotFoundException |
Rappresenta l'eccezione generata quando si tenta di restituire una versione di un DataRow oggetto eliminato. |
Interfacce
| Nome | Descrizione |
|---|---|
| IColumnMapping |
Associa una colonna di origine dati a una DataSet colonna e viene implementata dalla DataColumnMapping classe , usata in comune dai provider di dati .NET. |
| IColumnMappingCollection |
Contiene una raccolta di oggetti DataColumnMapping e viene implementata da DataColumnMappingCollection, che viene usata in comune dai provider di dati .NET. |
| IDataAdapter |
Consente a un oggetto di implementare un Oggetto DataAdapter e rappresenta un set di metodi e proprietà correlate all'azione di mapping utilizzate per compilare e aggiornare un'origine DataSet dati e aggiornare un'origine dati. IDbDataAdapter Le istanze sono destinate a origini dati (o simili) a database relazionali con comandi testuali (ad esempio Transact-SQL), mentre IDataAdapter le istanze possono usare qualsiasi tipo di origine dati. |
| IDataParameter |
Rappresenta un parametro per un oggetto Command e, facoltativamente, il relativo mapping alle colonne e viene implementato dai provider di dati .NET che accedono alle DataSet origini dati. |
| IDataParameterCollection |
Raccoglie tutti i parametri rilevanti per un oggetto Command e i relativi mapping alle colonne e viene implementato dai provider di dati .NET che accedono alle DataSet origini dati. |
| IDataReader |
Consente di leggere uno o più flussi forward-only dei set di risultati ottenuti eseguendo un comando in un'origine dati e viene implementato dai provider di dati .NET che accedono ai database relazionali. |
| IDataRecord |
Fornisce 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 set di proprietà correlate ai comandi utilizzate per riempire e aggiornare un'origine DataSet dati e viene implementato dai provider di dati .NET che accedono ai database relazionali. |
| IDbDataParameter |
Utilizzato dalle finestre di progettazione dati .NET di Visual Basic per rappresentare un parametro a un oggetto Command e, facoltativamente, il relativo mapping alle DataSet colonne. |
| 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 di colonna all'interno di ogni riga di un DbDataRecord oggetto per un oggetto DbDataReader. |
| ITableMapping |
Associa una tabella di origine a una tabella in un DataSetoggetto e viene implementata dalla DataTableMapping classe , usata in comune dai provider di dati .NET. |
| ITableMappingCollection |
Contiene una raccolta di oggetti TableMapping e viene implementata da DataTableMappingCollection, che viene usata in comune dai provider di dati .NET. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| AcceptRejectRule |
Determina l'azione che si verifica quando il metodo AcceptChanges() o RejectChanges() viene richiamato in un DataTable con un ForeignKeyConstraint. |
| CommandBehavior |
Fornisce una descrizione dei risultati della query e del relativo effetto sul database. |
| CommandType |
Specifica la modalità di interpretazione di una stringa di comando. |
| ConflictOption |
Specifica il modo in cui le modifiche in conflitto all'origine dati verranno rilevate e risolte. |
| ConnectionState |
Descrive lo stato corrente della connessione a un'origine dati. |
| DataRowAction |
Descrive un'azione eseguita su un DataRow. |
| DataRowState |
Ottiene lo stato di un oggetto DataRow. |
| DataRowVersion |
Descrive la versione di un DataRow. |
| DataSetDateTime |
Descrive il formato di serializzazione per le colonne DateTime in un DataSet. |
| DataViewRowState |
Descrive la versione dei dati in un DataRow. |
| DbType |
Specifica il tipo di dati di un campo, una proprietà o un oggetto |
| EntityState |
Stato di un oggetto entità. |
| IsolationLevel |
Specifica il comportamento di blocco delle transazioni per la connessione. |
| KeyRestrictionBehavior |
Identifica un elenco di parametri della stringa di connessione identificati dalla proprietà |
| LoadOption |
Controlla il modo in cui i valori dell'origine dati verranno applicati alle righe esistenti quando si usa il metodo Load o Load. |
| MappingType |
Specifica la modalità di mapping di un DataColumn. |
| MissingMappingAction |
Determina l'azione che si verifica quando un mapping non è presente in una tabella di origine o in una colonna di origine. |
| MissingSchemaAction |
Specifica l'azione da eseguire durante l'aggiunta di dati al DataSet e la DataTable o la DataColumn necessaria non è presente. |
| ParameterDirection |
Specifica il tipo di un parametro all'interno di una query rispetto al DataSet. |
| PropertyAttributes |
Specifica gli attributi di una proprietà. |
| Rule |
Indica l'azione che si verifica quando viene applicata una ForeignKeyConstraint. |
| SchemaSerializationMode |
Indica la modalità di serializzazione dello schema per un DataSettipizzato. |
| SchemaType |
Specifica come gestire i mapping dello schema esistenti durante l'esecuzione di un'operazione di FillSchema(DataSet, SchemaType). |
| SerializationFormat |
Determina il formato di serializzazione per un DataSet. |
| SqlDbType |
Specifica il tipo di dati specifico di SQL Server di un campo, proprietà, da usare in un SqlParameter. |
| StatementType |
Specifica il tipo di query SQL da usare dalla classe OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgso SqlRowUpdatingEventArgs . |
| UpdateRowSource |
Specifica la modalità di applicazione dei risultati dei comandi di query alla riga da aggiornare. |
| UpdateStatus |
Specifica l'azione da eseguire per quanto riguarda le righe correnti e rimanenti durante un Update(DataSet). |
| XmlReadMode |
Specifica come leggere i dati XML e uno schema relazionale in un DataSet. |
| XmlWriteMode |
Specifica come scrivere dati XML e uno schema relazionale da un DataSet. |
Delegati
| Nome | Descrizione |
|---|---|
| DataColumnChangeEventHandler |
Rappresenta il metodo che gestirà l'evento ColumnChanging . |
| DataRowChangeEventHandler |
Rappresenta il metodo che gestirà gli RowChangingeventi , RowDeletingRowChanged, e RowDeleted di un oggetto DataTable. |
| DataTableClearEventHandler |
Rappresenta il metodo che gestisce il Clear() metodo . |
| DataTableNewRowEventHandler |
Rappresenta il metodo che gestisce il NewRow() metodo . |
| 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 |
Tipo di delegato per i gestori eventi dell'evento StatementCompleted . |
Commenti
In uno scenario disconnesso, ad esempio Internet, ADO.NET fornisce gli strumenti per richiedere, aggiornare e riconciliare i dati in più sistemi di livello. L'architettura ADO.NET viene implementata anche nelle applicazioni client, ad esempio Windows Form o pagine HTML create da ASP.NET.
Il fulcro dell'architettura ADO.NET è la DataSet classe . Ognuno DataSet può contenere più DataTable oggetti, ognuno DataTable dei quali contiene dati di una singola origine dati, ad esempio SQL Server.
Ognuno DataTable contiene una DataColumnCollectionraccolta di DataColumn oggetti che determina lo schema di ogni DataTableoggetto . La DataType proprietà determina il tipo di dati contenuti nell'oggetto DataColumn. Le ReadOnly proprietà e AllowDBNull consentono di garantire ulteriormente l'integrità dei dati. La Expression proprietà consente di costruire colonne calcolate.
Se un oggetto DataTable partecipa a una relazione padre/figlio con un altro DataTableelemento , la relazione viene costruita aggiungendo un DataRelation oggetto a DataRelationCollection di un DataSet oggetto . Quando viene aggiunta una relazione di questo tipo, viene creato automaticamente un UniqueConstraint oggetto e , ForeignKeyConstraint a seconda delle impostazioni dei parametri per il costruttore. Garantisce UniqueConstraint che i valori contenuti in una colonna siano univoci. Determina ForeignKeyConstraint l'azione che accadrà alla riga o alla colonna figlio quando un valore di chiave primaria viene modificato o eliminato.
Usando lo System.Data.SqlClient spazio dei nomi (provider di dati the.NET Framework per SQL Server), lo System.Data.Odbc spazio dei nomi (provider di dati the.NET Framework per ODBC), lo System.Data.OleDb spazio dei nomi (provider di dati the.NET Framework per OLE DB) o lo System.Data.OracleClient spazio dei nomi (provider di dati .NET Framework per Oracle), è possibile accedere a un'origine dati da usare insieme a .DataSet Each.NET Framework data provider dispone di un DataAdapter corrispondente usato come bridge tra un'origine dati e un oggetto DataSet.