Condividi tramite


System.Data Spazio dei nomi

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 DataRowBuilder tipo supporta l'infrastruttura .NET e non deve essere usato direttamente dal codice.

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 EntityClient nomi. EntityException è la classe di base per tutte le eccezioni di Entity Framework generate da EntityClient.

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 DataRow hanno lo stesso valore di chiave primaria e la EnforceConstraints proprietà è impostata su true.

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

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 DataReaderoggetto e viene implementato dai provider di dati .NET che accedono ai 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 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 Parameter di un provider di dati .NET.

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à KeyRestrictions consentita o non consentita.

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.