DbCommandBuilder 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.
Hiermee worden automatisch opdrachten met één tabel gegenereerd die worden gebruikt voor het afstemmen van wijzigingen in een DataSet database met de bijbehorende database. Dit is een abstracte klasse die alleen kan worden overgenomen.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Overname
- Afgeleid
Opmerkingen
De DbCommandBuilder klasse is beschikbaar voor het gemak van providerschrijvers die hun eigen opbouwfuncties voor opdrachten maken. Door deze klasse over te nemen, kunnen ontwikkelaars providerspecifiek gedrag implementeren in hun eigen code.
De DbDataAdapter SQL-instructies die nodig zijn om wijzigingen in een DataSet gekoppelde gegevensbron af te stemmen, worden niet automatisch gegenereerd. U kunt echter een DbCommandBuilder object maken om automatisch SQL-instructies te genereren voor updates met één tabel als u de SelectCommand eigenschap van de DbDataAdapter. Vervolgens worden eventuele aanvullende SQL-instructies die u niet instelt, gegenereerd door de DbCommandBuilder.
De DbCommandBuilder registratie zelf als listener voor RowUpdating gebeurtenissen wanneer u de DataAdapter eigenschap instelt. U kunt slechts één DbDataAdapter object DbCommandBuilder tegelijk aan elkaar koppelen.
Voor het genereren van INSERT-, UPDATE- of DELETE-instructies gebruikt de DbCommandBuilderSelectCommand eigenschap om automatisch een vereiste set metagegevens op te halen. Als u de SelectCommand methode wijzigt nadat de metagegevens zijn opgehaald (bijvoorbeeld na de eerste update), moet u de RefreshSchema methode aanroepen om de metagegevens bij te werken.
De SelectCommand sleutel moet ook ten minste één primaire sleutel of unieke kolom retourneren. Als er geen bestaat, wordt er een InvalidOperationException uitzondering gegenereerd en worden de opdrachten niet gegenereerd.
Het DbCommandBuilder maakt ook gebruik van de Connection, CommandTimeouten Transaction eigenschappen waarnaar wordt verwezen door de SelectCommand. De gebruiker moet aanroepen RefreshSchema of een van deze eigenschappen wordt gewijzigd of als de SelectCommand zelf wordt vervangen. Anders behouden de InsertCommand, UpdateCommanden DeleteCommand eigenschappen de vorige waarden.
Als u aanroept Dispose, wordt de DbCommandBuilder koppeling losgekoppeld van de DbDataAdapteren worden de gegenereerde opdrachten niet meer gebruikt.
Constructors
| Name | Description |
|---|---|
| DbCommandBuilder() |
Initialiseert een nieuw exemplaar van een klasse die wordt overgenomen van de DbCommandBuilder klasse. |
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. |
| CatalogSeparator |
Hiermee haalt u een tekenreeks op die wordt gebruikt als het catalogusscheidingsteken voor een exemplaar van de DbCommandBuilder klasse. |
| ConflictOption |
Hiermee geeft u op welke ConflictOption moet worden gebruikt door de DbCommandBuilder. |
| Container |
Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component) |
| DataAdapter |
Hiermee wordt een DbDataAdapter-object opgehaald of ingesteld waarvoor automatisch Transact-SQL instructies 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. |
| 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. |
| SchemaSeparator |
Hiermee haalt u het teken op dat moet worden gebruikt voor het scheidingsteken tussen de schema-id en eventuele andere id's. |
| SetAllValues |
Hiermee geeft u op of alle kolomwaarden in een update-instructie worden opgenomen of alleen worden gewijzigd. |
| 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. |
| 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) |
| Dispose() |
Alle resources die worden gebruikt door de Component. (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. |
| 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 DbCommand is vereist voor het uitvoeren van verwijderingen bij de gegevensbron. |
| GetDeleteCommand(Boolean) |
Hiermee haalt u het automatisch gegenereerde DbCommand object op dat is vereist voor het uitvoeren van verwijderingen bij de gegevensbron, optioneel met behulp van kolommen voor parameternamen. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetInsertCommand() |
Hiermee wordt het automatisch gegenereerde object opgehaald dat DbCommand is vereist voor het uitvoeren van invoegingen in de gegevensbron. |
| GetInsertCommand(Boolean) |
Hiermee wordt het automatisch gegenereerde object opgehaald dat DbCommand is vereist voor het uitvoeren van invoegingen in de gegevensbron, optioneel met behulp van kolommen voor parameternamen. |
| 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 |
| GetParameterName(String) |
Retourneert de volledige parameternaam, op basis van de naam van de gedeeltelijke parameter. |
| GetParameterPlaceholder(Int32) |
Retourneert de tijdelijke aanduiding voor de parameter in de bijbehorende SQL-instructie. |
| GetSchemaTable(DbCommand) |
Retourneert de schematabel voor de 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 DbCommand is vereist voor het uitvoeren van updates bij de gegevensbron. |
| GetUpdateCommand(Boolean) |
Hiermee wordt het automatisch gegenereerde object opgehaald dat DbCommand 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 UpdateRowSourceCommandTypeeigenschappen van de DbCommand. |
| 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) |
Met een niet-aanhalingsteken in de juiste cataloguscase wordt de juiste aanhalingstekens van die id geretourneerd, inclusief het correct ontsnappen van ingesloten aanhalingstekens in de id. |
| RefreshSchema() |
Hiermee wist u de opdrachten die aan deze DbCommandBuilderopdracht zijn gekoppeld. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Voegt een gebeurtenis-handler toe voor de RowUpdating gebeurtenis. |
| SetRowUpdatingHandler(DbDataAdapter) |
Registreert de DbCommandBuilder gebeurtenis voor een RowUpdatingDbDataAdapter. |
| ToString() |
Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van Component) |
| UnquoteIdentifier(String) |
Met een aanhalingsteken-id wordt de juiste niet-aanhalingstekens van die id geretourneerd, inclusief 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) |