OleDbDataAdapter Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vertegenwoordigt een set gegevensopdrachten en een databaseverbinding die wordt gebruikt om de DataSet gegevensbron te vullen en bij te werken.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable- Overname
- Implementeringen
Voorbeelden
In het volgende voorbeeld worden de OleDbCommandrecords OleDbDataAdapter uit een Access-gegevensbron geselecteerd en OleDbConnectionwordt een DataSet record gevuld met de geselecteerde rijen. De opgevulde DataSet waarde wordt vervolgens geretourneerd. Hiervoor wordt de methode doorgegeven aan een geïnitialiseerde DataSet, een verbindingsreeks en een queryreeks die een SQL SELECT-instructie is.
public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
OleDbConnection connection)
{
OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the Insert, Update and Delete commands.
adapter.InsertCommand = new OleDbCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (?, ?)");
adapter.UpdateCommand = new OleDbCommand(
"UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
"WHERE CustomerID = ?");
adapter.DeleteCommand = new OleDbCommand(
"DELETE FROM Customers WHERE CustomerID = ?");
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
OleDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
OleDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
OleDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
OleDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
return adapter;
}
Public Function CreateDataAdapter(ByVal selectCommand As String, _
ByVal connection As OleDbConnection) As OleDbDataAdapter
Dim adapter As OleDbDataAdapter = _
New OleDbDataAdapter(selectCommand, connection)
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.InsertCommand = New OleDbCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (?, ?)")
adapter.UpdateCommand = New OleDbCommand( _
"UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
"WHERE CustomerID = ?")
adapter.DeleteCommand = New OleDbCommand( _
"DELETE FROM Customers WHERE CustomerID = ?")
' Create the parameters.
adapter.InsertCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add( _
"@CompanyName", OleDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add( _
"@CompanyName", OleDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add( _
"@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add( _
"@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
Return adapter
End Function
Opmerkingen
De OleDbDataAdapter functie fungeert als een brug tussen een DataSet en gegevensbron voor het ophalen en opslaan van gegevens. Deze OleDbDataAdapter brug biedt deze brug door gegevens Fill uit de gegevensbron in de DataSetgegevensbron te laden en om Update wijzigingen in de DataSet back-up naar de gegevensbron te verzenden.
Wanneer de OleDbDataAdapter gegevens worden DataSetingevuld, worden de juiste tabellen en kolommen voor de geretourneerde gegevens gemaakt als deze nog niet bestaan. Primaire-sleutelgegevens worden echter niet opgenomen in het impliciet gemaakte schema, tenzij de MissingSchemaAction eigenschap is ingesteld op AddWithKey. Mogelijk hebt u ook het OleDbDataAdapter schema van de DataSet, inclusief primaire-sleutelgegevens, voordat u het met gegevens invult.FillSchema Zie Bestaande beperkingen toevoegen aan een dataset voor meer informatie.
Houd er rekening mee dat sommige OLE DB-providers, waaronder de MSDataShape-provider, geen basistabel- of primaire-sleutelgegevens retourneren. Daarom kan de OleDbDataAdapterPrimaryKey eigenschap niet correct worden ingesteld op een gemaakte DataTable. In deze gevallen moet u expliciet primaire sleutels opgeven voor tabellen in de DataSet.
Het OleDbDataAdapter omvat ook de SelectCommandeigenschappen , InsertCommand, DeleteCommanden UpdateCommandTableMappings eigenschappen om het laden en bijwerken van gegevens te vergemakkelijken.
Wanneer u een instantie van OleDbDataAdaptermaakt, worden eigenschappen ingesteld op de oorspronkelijke waarden. Zie de OleDbDataAdapter constructor voor een lijst met deze waarden.
Constructors
| Name | Description |
|---|---|
| OleDbDataAdapter() |
Initialiseert een nieuw exemplaar van de OleDbDataAdapter klasse. |
| OleDbDataAdapter(OleDbCommand) |
Initialiseert een nieuw exemplaar van de OleDbDataAdapter klasse met de opgegeven OleDbCommand eigenschap SelectCommand . |
| OleDbDataAdapter(String, OleDbConnection) |
Initialiseert een nieuw exemplaar van de OleDbDataAdapter klasse met een SelectCommand. |
| OleDbDataAdapter(String, String) |
Initialiseert een nieuw exemplaar van de OleDbDataAdapter klasse met een SelectCommand. |
Velden
| Name | Description |
|---|---|
| DefaultSourceTableName |
De standaardnaam die wordt gebruikt door het DataAdapter object voor tabeltoewijzingen. (Overgenomen van DbDataAdapter) |
Eigenschappen
| Name | Description |
|---|---|
| AcceptChangesDuringFill |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of AcceptChanges() er een DataRow wordt aangeroepen nadat deze is toegevoegd aan een DataTable van de opvulbewerkingen . (Overgenomen van DataAdapter) |
| AcceptChangesDuringUpdate |
Haalt of stelt in of AcceptChanges() wordt aangeroepen tijdens een Update(DataSet). (Overgenomen van DataAdapter) |
| CanRaiseEvents |
Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component) |
| Container |
Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component) |
| ContinueUpdateOnError |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of er een uitzondering moet worden gegenereerd wanneer er een fout optreedt tijdens een rijupdate. (Overgenomen van DataAdapter) |
| DeleteCommand |
Hiermee haalt u een SQL-instructie of opgeslagen procedure op voor het verwijderen van records uit de gegevensset. |
| DesignMode |
Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is. (Overgenomen van Component) |
| Events |
Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld. (Overgenomen van Component) |
| FillCommandBehavior |
Hiermee wordt het gedrag opgehaald of ingesteld van de opdracht die wordt gebruikt om de gegevensadapter te vullen. (Overgenomen van DbDataAdapter) |
| FillLoadOption |
Hiermee wordt de LoadOption adapter opgehaald of ingesteld die bepaalt hoe de adapter de DataTable opvult van de DbDataReader. (Overgenomen van DataAdapter) |
| InsertCommand |
Hiermee haalt u een SQL-instructie of opgeslagen procedure op die wordt gebruikt om nieuwe records in de gegevensbron in te voegen. |
| MissingMappingAction |
Bepaalt de actie die moet worden uitgevoerd wanneer binnenkomende gegevens geen overeenkomende tabel of kolom hebben. (Overgenomen van DataAdapter) |
| MissingSchemaAction |
Bepaalt de actie die moet worden uitgevoerd wanneer het bestaande DataSet schema niet overeenkomt met binnenkomende gegevens. (Overgenomen van DataAdapter) |
| ReturnProviderSpecificTypes |
Hiermee wordt opgehaald of ingesteld of de |
| SelectCommand |
Hiermee haalt u een SQL-instructie of opgeslagen procedure op die wordt gebruikt om records in de gegevensbron te selecteren. |
| Site |
Haalt of stelt de ISite van de Component. (Overgenomen van Component) |
| TableMappings |
Hiermee haalt u een verzameling op die de primaire toewijzing tussen een brontabel en een DataTable. (Overgenomen van DataAdapter) |
| UpdateBatchSize |
Hiermee haalt u een waarde op die ondersteuning voor batchverwerking inschakelt of uitschakelt en geeft u het aantal opdrachten op dat in een batch kan worden uitgevoerd. (Overgenomen van DbDataAdapter) |
| UpdateCommand |
Hiermee haalt u een SQL-instructie of opgeslagen procedure op die wordt gebruikt om records in de gegevensbron bij te werken. |
Methoden
| Name | Description |
|---|---|
| AddToBatch(IDbCommand) |
Voegt een IDbCommand aan de huidige batch toe. (Overgenomen van DbDataAdapter) |
| ClearBatch() |
Hiermee verwijdert u alle IDbCommand objecten uit de batch. (Overgenomen van DbDataAdapter) |
| CloneInternals() |
Verouderd.
Verouderd.
Verouderd.
Hiermee maakt u een kopie van dit exemplaar van DataAdapter. (Overgenomen van DataAdapter) |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Initialiseert een nieuw exemplaar van de RowUpdatedEventArgs klasse. (Overgenomen van DbDataAdapter) |
| CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Initialiseert een nieuw exemplaar van de RowUpdatingEventArgs klasse. (Overgenomen van DbDataAdapter) |
| CreateTableMappings() |
Hiermee maakt u een nieuwe DataTableMappingCollection. (Overgenomen van DataAdapter) |
| Dispose() |
Alle resources die worden gebruikt door de Component. (Overgenomen van Component) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de DbDataAdapter beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van DbDataAdapter) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| ExecuteBatch() |
Hiermee wordt de huidige batch uitgevoerd. (Overgenomen van DbDataAdapter) |
| Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Hiermee worden rijen in een opgegeven bereik in het DataSet opgegeven bereik toegevoegd of vernieuwd, zodat deze overeenkomen met de rijen in de gegevensbron met behulp van de namen van de DataSet en brontabellen, de opdrachtreeks en het gedrag van de opdracht. (Overgenomen van DbDataAdapter) |
| Fill(DataSet, Int32, Int32, String) |
Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd, DataSet zodat deze overeenkomen met rijen in de gegevensbron met behulp van de DataSet en DataTable namen. (Overgenomen van DbDataAdapter) |
| Fill(DataSet, Object, String) |
Hiermee worden rijen in de DataSet rijen toegevoegd of vernieuwd die overeenkomen met die in een ADO |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd, DataSet zodat deze overeenkomen met rijen in de gegevensbron met behulp van de DataSet, DataTableen IDataReader namen. (Overgenomen van DbDataAdapter) |
| Fill(DataSet, String) |
Hiermee worden rijen in de DataSet rijen toegevoegd of vernieuwd die overeenkomen met de rijen in de gegevensbron met behulp van de DataSet en DataTable namen. (Overgenomen van DbDataAdapter) |
| Fill(DataSet) |
Rijen toevoegen of vernieuwen in de DataSet. (Overgenomen van DbDataAdapter) |
| Fill(DataTable, IDataReader) |
Voegt rijen in een DataTable rij toe of vernieuwt deze zodat deze overeenkomen met de rijen in de gegevensbron met behulp van de opgegeven DataTable namen en IDataReader namen. (Overgenomen van DbDataAdapter) |
| Fill(DataTable, IDbCommand, CommandBehavior) |
Voegt rijen in een DataTable rij toe of vernieuwt deze zodat deze overeenkomen met de rijen in de gegevensbron met behulp van de opgegeven DataTable, IDbCommand en CommandBehavior. (Overgenomen van DbDataAdapter) |
| Fill(DataTable, Object) |
Hiermee worden rijen in een rij DataTable toegevoegd of vernieuwd die overeenkomen met die in een ADO |
| Fill(DataTable) |
Hiermee worden rijen in een opgegeven bereik in het DataSet opgegeven bereik toegevoegd of vernieuwd, zodat deze overeenkomen met de rijen in de gegevensbron met behulp van de DataTable naam. (Overgenomen van DbDataAdapter) |
| Fill(DataTable[], IDataReader, Int32, Int32) |
Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd in de verzameling DataTable objecten die overeenkomen met die in de gegevensbron. (Overgenomen van DataAdapter) |
| Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Hiermee worden rijen in een opgegeven bereik toegevoegd of vernieuwd, DataSet zodat deze overeenkomen met rijen in de gegevensbron met behulp van de DataSet en DataTable namen. (Overgenomen van DbDataAdapter) |
| Fill(Int32, Int32, DataTable[]) |
Hiermee worden rijen in een of meer DataTable objecten toegevoegd of vernieuwd zodat deze overeenkomen met de rijen in de gegevensbron die beginnen bij de opgegeven record en maximaal het opgegeven maximum aantal records worden opgehaald. (Overgenomen van DbDataAdapter) |
| FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Voegt een DataTable toe aan de opgegeven DataSet en configureert het schema zodat het overeenkomt met dat in de gegevensbron op basis van de opgegeven SchemaType. (Overgenomen van DbDataAdapter) |
| FillSchema(DataSet, SchemaType, String, IDataReader) |
Voegt een DataTable toe aan de opgegeven DataSet. (Overgenomen van DataAdapter) |
| FillSchema(DataSet, SchemaType, String) |
Voegt een DataTable toe aan de opgegeven DataSet en configureert het schema zodat het overeenkomt met dat in de gegevensbron op basis van de opgegeven SchemaType en DataTable. (Overgenomen van DbDataAdapter) |
| FillSchema(DataSet, SchemaType) |
Voegt een DataTable benoemde tabel toe aan de opgegeven DataSet en configureert het schema zodat het overeenkomt met het schema in de gegevensbron op basis van de opgegeven SchemaType. (Overgenomen van DbDataAdapter) |
| FillSchema(DataTable, SchemaType, IDataReader) |
Voegt een DataTable toe aan de opgegeven DataSet. (Overgenomen van DataAdapter) |
| FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Hiermee configureert u het schema van de opgegeven op basis van de opgegeven DataTableSchemaTypeopdrachtreeks en CommandBehavior waarden. (Overgenomen van DbDataAdapter) |
| FillSchema(DataTable, SchemaType) |
Hiermee configureert u het schema van de opgegeven DataTable op basis van de opgegeven SchemaType. (Overgenomen van DbDataAdapter) |
| GetBatchedParameter(Int32, Int32) |
Retourneert een IDataParameter van de opdrachten in de huidige batch. (Overgenomen van DbDataAdapter) |
| GetBatchedRecordsAffected(Int32, Int32, Exception) |
Retourneert informatie over een afzonderlijke updatepoging binnen een grotere batch-update. (Overgenomen van DbDataAdapter) |
| GetFillParameters() |
Hiermee haalt u de parameters op die door de gebruiker zijn ingesteld bij het uitvoeren van een SQL SELECT-instructie. (Overgenomen van DbDataAdapter) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetLifetimeService() |
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetService(Type) |
Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container. (Overgenomen van Component) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| HasTableMappings() |
Geeft aan of er een DataTableMappingCollection is gemaakt. (Overgenomen van DataAdapter) |
| InitializeBatching() |
Initialiseert batchverwerking voor de DbDataAdapter. (Overgenomen van DbDataAdapter) |
| InitializeLifetimeService() |
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| OnFillError(FillErrorEventArgs) |
Hiermee wordt de FillError gebeurtenis gegenereerd. (Overgenomen van DbDataAdapter) |
| OnRowUpdated(RowUpdatedEventArgs) |
Hiermee wordt de |
| OnRowUpdating(RowUpdatingEventArgs) |
Hiermee wordt de |
| ResetFillLoadOption() |
FillLoadOption Stelt de standaardstatus opnieuw in en zorgt ervoor dat deze Fill(DataSet) wordt uitgevoerdAcceptChangesDuringFill. (Overgenomen van DataAdapter) |
| ShouldSerializeAcceptChangesDuringFill() |
Bepaalt of de AcceptChangesDuringFill eigenschap moet worden behouden. (Overgenomen van DataAdapter) |
| ShouldSerializeFillLoadOption() |
Bepaalt of de FillLoadOption eigenschap moet worden behouden. (Overgenomen van DataAdapter) |
| ShouldSerializeTableMappings() |
Bepaalt of er een of meer DataTableMapping objecten bestaan en deze moeten worden bewaard. (Overgenomen van DataAdapter) |
| TerminateBatching() |
Eindigt batchverwerking voor de DbDataAdapter. (Overgenomen van DbDataAdapter) |
| ToString() |
Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van Component) |
| Update(DataRow[], DataTableMapping) |
Hiermee worden de waarden in de database bijgewerkt door de respectieve INSERT-, UPDATE- of DELETE-instructies uit te voeren voor elke ingevoegde, bijgewerkte of verwijderde rij in de opgegeven matrix met DataRow objecten. (Overgenomen van DbDataAdapter) |
| Update(DataRow[]) |
Werkt de waarden in de database bij door de respectieve INSERT-, UPDATE- of DELETE-instructies uit te voeren voor elke ingevoegde, bijgewerkte of verwijderde rij in de opgegeven matrix in de DataSetopgegeven matrix. (Overgenomen van DbDataAdapter) |
| Update(DataSet, String) |
Werkt de waarden in de database bij door de respectieve INSERT-, UPDATE- of DELETE-instructies uit te voeren voor elke ingevoegde, bijgewerkte of verwijderde rij in de DataSet opgegeven DataTable naam. (Overgenomen van DbDataAdapter) |
| Update(DataSet) |
Hiermee worden de waarden in de database bijgewerkt door de respectieve INSERT-, UPDATE- of DELETE-instructies uit te voeren voor elke ingevoegde, bijgewerkte of verwijderde rij in de opgegeven DataSet. (Overgenomen van DbDataAdapter) |
| Update(DataTable) |
Hiermee worden de waarden in de database bijgewerkt door de respectieve INSERT-, UPDATE- of DELETE-instructies uit te voeren voor elke ingevoegde, bijgewerkte of verwijderde rij in de opgegeven DataTable. (Overgenomen van DbDataAdapter) |
gebeurtenis
| Name | Description |
|---|---|
| Disposed |
Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component) |
| FillError |
Geretourneerd wanneer er een fout optreedt tijdens een vulbewerking. (Overgenomen van DbDataAdapter) |
| RowUpdated |
Vindt plaats tijdens Update(DataSet) het uitvoeren van een opdracht op basis van de gegevensbron. De poging om bij te werken wordt uitgevoerd. Daarom vindt de gebeurtenis plaats. |
| RowUpdating |
Vindt plaats voordat Update(DataSet) een opdracht wordt uitgevoerd op basis van de gegevensbron. De poging om bij te werken wordt uitgevoerd. Daarom vindt de gebeurtenis plaats. |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| ICloneable.Clone() |
Zie voor een beschrijving van dit lid Clone(). |
| IDataAdapter.TableMappings |
Hiermee haalt u een verzameling op die aangeeft hoe een brontabel wordt toegewezen aan een gegevenssettabel. (Overgenomen van DataAdapter) |
| IDbDataAdapter.DeleteCommand |
Zie voor een beschrijving van dit lid DeleteCommand. |
| IDbDataAdapter.InsertCommand |
Zie voor een beschrijving van dit lid InsertCommand. |
| IDbDataAdapter.SelectCommand |
Zie voor een beschrijving van dit lid SelectCommand. |
| IDbDataAdapter.UpdateCommand |
Zie voor een beschrijving van dit lid UpdateCommand. |