OleDbCommandBuilder Klas

Definitie

Naamruimte:: System.Data.OleDb

Assembly:: System.Data.dll

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.

Hiermee worden automatisch opdrachten met één tabel gegenereerd die worden gebruikt voor het afstemmen van wijzigingen in een DataSet database met de bijbehorende database. Deze klasse kan niet worden overgenomen.

public ref class OleDbCommandBuilder sealed : System::ComponentModel::Component

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.ComponentModel.Component

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit Component

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits Component

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Overname: Object

MarshalByRefObject

Component
OleDbCommandBuilder

Overname: Object

MarshalByRefObject

Component

DbCommandBuilder
OleDbCommandBuilder

Voorbeelden

In het volgende voorbeeld worden de OleDbCommandrijen uit een gegevensbron gebruikt OleDbDataAdapter om OleDbConnectionrijen te selecteren. Het voorbeeld wordt doorgegeven aan een geïnitialiseerde DataSet, een verbindingsreeks, een queryreeks die een SQL SELECT-instructie is en een tekenreeks die de naam is van de gegevensbrontabel. In het voorbeeld wordt vervolgens een OleDbCommandBuilder.

public static DataSet UpdateRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        cb.GetDeleteCommand();
        //Without the OleDbCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        connection.Close();
    }
    return dataSet;
}

Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the OleDbCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

Opmerkingen

De OleDbDataAdapter SQL-instructies die nodig zijn om wijzigingen in een DataSet gekoppelde gegevensbron af te stemmen, worden niet automatisch gegenereerd. U kunt echter een OleDbCommandBuilder object maken om automatisch SQL-instructies te genereren voor updates met één tabel als u de SelectCommand eigenschap van de OleDbDataAdapter. Vervolgens worden eventuele aanvullende SQL-instructies die u niet instelt, gegenereerd door de OleDbCommandBuilder.

De OleDbCommandBuilder registratie zelf als listener voor RowUpdating gebeurtenissen wanneer u de DataAdapter eigenschap instelt. U kunt slechts één OleDbDataAdapter object OleDbCommandBuilder tegelijk aan elkaar koppelen.

Voor het genereren van INSERT-, UPDATE- of DELETE-instructies gebruikt de OleDbCommandBuilder SelectCommand eigenschap om automatisch een vereiste set metagegevens op te halen. Als u de SelectCommand metagegevens wijzigt nadat de metagegevens zijn opgehaald, zoals na de eerste update, moet u de RefreshSchema methode aanroepen om de metagegevens bij te werken.

Het OleDbCommandBuilder maakt ook gebruik van de Connection, CommandTimeouten Transaction eigenschappen waarnaar wordt verwezen door de SelectCommand. De gebruiker moet aanroepen RefreshSchema of een of meer van deze eigenschappen worden gewijzigd of als de SelectCommand zelf wordt vervangen. Anders behouden de InsertCommand, UpdateCommanden DeleteCommand eigenschappen de vorige waarden.

Als u aanroept Dispose, wordt de OleDbCommandBuilder koppeling losgekoppeld van de OleDbDataAdapteren worden de gegenereerde opdrachten niet meer gebruikt.

Constructors

Name	Description
OleDbCommandBuilder()	Initialiseert een nieuw exemplaar van de OleDbCommandBuilder klasse.
OleDbCommandBuilder(OleDbDataAdapter)	Initialiseert een nieuw exemplaar van de OleDbCommandBuilder klasse met het bijbehorende OleDbDataAdapter object.

Eigenschappen

Name	Description
CanRaiseEvents	Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component)
CatalogLocation	Hiermee haalt u een CatalogLocation exemplaar van de klasse op of stelt u deze DbCommandBuilder in. (Overgenomen van DbCommandBuilder)
CatalogSeparator	Hiermee haalt u een tekenreeks op die wordt gebruikt als het catalogusscheidingsteken voor een exemplaar van de DbCommandBuilder klasse. (Overgenomen van DbCommandBuilder)
ConflictOption	Hiermee geeft u op welke ConflictOption moet worden gebruikt door de DbCommandBuilder. (Overgenomen van DbCommandBuilder)
Container	Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component)
DataAdapter	Hiermee wordt een OleDbDataAdapter object opgehaald of ingesteld waarvoor SQL-instructies automatisch worden gegenereerd.
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)
QuotePrefix	Hiermee haalt u het beginteken of de begintekens op die moeten worden gebruikt bij het opgeven van databaseobjecten (bijvoorbeeld tabellen of kolommen) waarvan de namen tekens bevatten, zoals spaties of gereserveerde tokens.
QuotePrefix	Hiermee haalt u het beginteken of de begintekens op die moeten worden gebruikt bij het opgeven van databaseobjecten (bijvoorbeeld tabellen of kolommen) waarvan de namen tekens bevatten, zoals spaties of gereserveerde tokens. (Overgenomen van DbCommandBuilder)
QuoteSuffix	Hiermee haalt u het eindteken of de tekens op die moeten worden gebruikt bij het opgeven van databaseobjecten (bijvoorbeeld tabellen of kolommen) waarvan de namen tekens bevatten, zoals spaties of gereserveerde tokens.
QuoteSuffix	Hiermee haalt u het eindteken of de tekens op die moeten worden gebruikt bij het opgeven van databaseobjecten (bijvoorbeeld tabellen of kolommen) waarvan de namen tekens bevatten, zoals spaties of gereserveerde tokens. (Overgenomen van DbCommandBuilder)
SchemaSeparator	Hiermee haalt u het teken op dat moet worden gebruikt voor het scheidingsteken tussen de schema-id en eventuele andere id's. (Overgenomen van DbCommandBuilder)
SetAllValues	Hiermee geeft u op of alle kolomwaarden in een update-instructie worden opgenomen of alleen worden gewijzigd. (Overgenomen van DbCommandBuilder)
Site	Haalt of stelt de ISite van de Component. (Overgenomen van Component)

Methoden

Name	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Hiermee kan de provider-implementatie van de DbCommandBuilder klasse aanvullende parametereigenschappen verwerken. (Overgenomen van DbCommandBuilder)
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)
DeriveParameters(OleDbCommand)	Hiermee haalt u parametergegevens op uit de opgeslagen procedure die is opgegeven in de OleDbCommand en vult u de Parameters verzameling van het opgegeven OleDbCommand object.
Dispose()	Alle resources die worden gebruikt door de Component. (Overgenomen van Component)
Dispose(Boolean)	Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Component)
Dispose(Boolean)	Publiceert de niet-beheerde resources die worden gebruikt door de DbCommandBuilder beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van DbCommandBuilder)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetDeleteCommand()	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van verwijderingen bij de gegevensbron.
GetDeleteCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van verwijderingen bij de gegevensbron.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetInsertCommand()	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van invoegingen in de gegevensbron.
GetInsertCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van invoegingen in de gegevensbron.
GetLifetimeService()	Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetParameterName(Int32)	Retourneert de naam van de opgegeven parameter in de notatie van `@p#`. Gebruiken bij het bouwen van een aangepaste opbouwfunctie voor opdrachten. (Overgenomen van DbCommandBuilder)
GetParameterName(String)	Retourneert de volledige parameternaam, op basis van de naam van de gedeeltelijke parameter. (Overgenomen van DbCommandBuilder)
GetParameterPlaceholder(Int32)	Retourneert de tijdelijke aanduiding voor de parameter in de bijbehorende SQL-instructie. (Overgenomen van DbCommandBuilder)
GetSchemaTable(DbCommand)	Retourneert de schematabel voor de DbCommandBuilder. (Overgenomen van DbCommandBuilder)
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)
GetUpdateCommand()	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van updates bij de gegevensbron.
GetUpdateCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OleDbCommand is vereist voor het uitvoeren van updates bij de gegevensbron, optioneel met behulp van kolommen voor parameternamen.
InitializeCommand(DbCommand)	Hiermee stelt u de CommandTimeouteigenschappen , Transactionen UpdateRowSource CommandTypeeigenschappen van de DbCommand. (Overgenomen van DbCommandBuilder)
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)
QuoteIdentifier(String, OleDbConnection)	Met een niet-aanhalingeerde id in de juiste cataloguscase wordt de juiste aanhalingsvorm van die id geretourneerd. Dit omvat het correct ontsnappen van ingesloten aanhalingstekens in de id.
QuoteIdentifier(String)	Met een niet-aanhalingeerde id in de juiste cataloguscase wordt de juiste aanhalingsvorm van die id geretourneerd. Dit omvat het correct ontsnappen van ingesloten aanhalingstekens in de id.
RefreshSchema()	Hiermee wist u de opdrachten die aan deze OleDbCommandBuilderopdracht zijn gekoppeld.
RefreshSchema()	Hiermee wist u de opdrachten die aan deze DbCommandBuilderopdracht zijn gekoppeld. (Overgenomen van DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Voegt een gebeurtenis-handler toe voor de RowUpdating gebeurtenis. (Overgenomen van DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Registreert de DbCommandBuilder gebeurtenis voor een RowUpdating DbDataAdapter. (Overgenomen van DbCommandBuilder)
ToString()	Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van Component)
UnquoteIdentifier(String, OleDbConnection)	Met een aanhalings-id wordt de juiste niet-aanhalingeerde vorm van die id geretourneerd. Dit omvat het correct ontkomen van ingesloten aanhalingstekens in de id.
UnquoteIdentifier(String)	Met een aanhalings-id wordt de juiste niet-aanhalingeerde vorm van die id geretourneerd. Dit omvat het correct ontkomen van ingesloten aanhalingstekens in de id.

gebeurtenis

Name	Description
Disposed	Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component)

Van toepassing op

Zie ook

Opdrachten genereren met CommandBuilders

Feedback

Is deze pagina nuttig?