OdbcCommandBuilder Klas

Definitie

Naamruimte:: System.Data.Odbc

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 om wijzigingen in een DataSet met de bijbehorende gegevensbron af te stemmen. Deze klasse kan niet worden overgenomen.

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

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

public sealed class OdbcCommandBuilder : System.ComponentModel.Component

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

type OdbcCommandBuilder = class
    inherit Component

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits Component

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Overname: Object

MarshalByRefObject

Component
OdbcCommandBuilder

Overname: Object

MarshalByRefObject

Component

DbCommandBuilder
OdbcCommandBuilder

Voorbeelden

In het volgende voorbeeld worden OdbcCommandrijen uit een gegevensbron samen met OdbcDataAdapter en OdbcConnectiongeselecteerd. 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 OdbcCommandBuilder.

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}

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

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

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

    Return dataSet
End Function

Opmerkingen

De OdbcDataAdapter SQL-instructies die nodig zijn voor het afstemmen van wijzigingen die zijn aangebracht in een DataSet gekoppelde gegevensbron, worden niet automatisch gegenereerd. U kunt echter een OdbcCommandBuilder object maken waarmee SQL-instructies voor updates van één tabel worden gegenereerd door de SelectCommand eigenschap van de OdbcDataAdapter. Vervolgens OdbcCommandBuilder worden eventuele aanvullende SQL-instructies gegenereerd die u niet instelt.

De relatie tussen een OdbcDataAdapter en de bijbehorende OdbcCommandBuilder is altijd een-op-een. Als u deze correspondentie wilt maken, stelt u de OdbcDataAdapter eigenschap van het OdbcCommandBuilder object in. Dit zorgt ervoor dat het OdbcCommandBuilder zich registreert als een listener, die de uitvoer produceert van RowUpdating gebeurtenissen die van invloed zijn op de DataSet.

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

Note

Als de SELECT-instructie die aan de SelectCommand eigenschap is toegewezen, aliassen van kolomnamen gebruikt, kunnen de resulterende INSERT-, UPDATE- en DELETE-instructies onnauwkeurig zijn of mislukken. Als het onderliggende ODBC-stuurprogramma niet de juiste basiskolomnaam kan opgeven voor de aliaskolomnaam (met behulp van de SQL_DESC_BASE_COLUMN_NAME waarde), SQLColAttributekan de aliasnaam worden gebruikt in de gegenereerde instructies INSERT, UPDATE en DELETE. Het Microsoft ODBC-stuurprogramma voor Oracle retourneert bijvoorbeeld de aliasnaam als de naam van de basiskolom. De gegenereerde INSERT-, UPDATE- en DELETE-instructies veroorzaken daarom fouten.

Het OdbcCommandBuilder 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 waarde van de SelectCommand eigenschap zelf wordt gewijzigd. Anders behouden de InsertCommand, UpdateCommanden DeleteCommand eigenschappen de vorige waarden.

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

Constructors

Name	Description
OdbcCommandBuilder()	Initialiseert een nieuw exemplaar van de OdbcCommandBuilder klasse.
OdbcCommandBuilder(OdbcDataAdapter)	Initialiseert een nieuw exemplaar van de OdbcCommandBuilder klasse met het bijbehorende OdbcDataAdapter 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 OdbcDataAdapter object opgehaald of ingesteld waarvoor dit OdbcCommandBuilder object SQL-instructies genereert.
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 werken met 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 werken met 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(OdbcCommand)	Hiermee haalt u parametergegevens op uit de opgeslagen procedure die is opgegeven in de OdbcCommand en vult u de Parameters verzameling van het opgegeven OdbcCommand 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 OdbcCommand is vereist voor het uitvoeren van verwijderingen bij de gegevensbron.
GetDeleteCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OdbcCommand 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 OdbcCommand is vereist voor het uitvoeren van invoegingen in de gegevensbron.
GetInsertCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OdbcCommand 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 OdbcCommand is vereist voor het uitvoeren van updates bij de gegevensbron.
GetUpdateCommand(Boolean)	Hiermee wordt het automatisch gegenereerde object opgehaald dat OdbcCommand is vereist voor het uitvoeren van updates bij de gegevensbron.
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, OdbcConnection)	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 OdbcCommandBuilderopdracht 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, OdbcConnection)	Met een aanhalingsteken-id wordt de juiste niet-aanhalingstekens van die id geretourneerd, inclusief het correct weergeven van ingesloten aanhalingstekens in de id.
UnquoteIdentifier(String)	Met een aanhalingsteken-id wordt de juiste niet-aanhalingstekens van die id geretourneerd, inclusief het correct weergeven 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?