OracleCommandBuilder Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Achtung
OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260
Generiert automatisch Befehle für einzelne Tabellen, durch die an einem DataSet vorgenommene Änderungen mit der zugeordneten Datenbank abgeglichen werden. Diese Klasse kann nicht vererbt werden.
public ref class OracleCommandBuilder sealed : System::ComponentModel::Componentpublic ref class OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic sealed class OracleCommandBuilder : System.ComponentModel.Componentpublic sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuilder[System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuildertype OracleCommandBuilder = class
inherit Componenttype OracleCommandBuilder = class
inherit DbCommandBuilder[<System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommandBuilder = class
inherit DbCommandBuilderPublic NotInheritable Class OracleCommandBuilder
Inherits ComponentPublic NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder- Vererbung
- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird OracleCommandzusammen mit OracleDataAdapter und OracleConnectionverwendet, um Zeilen aus einer Datenbank auszuwählen. Im Beispiel wird eine initialisierte DataSet, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, bei der es sich um eine SQL SELECT-Anweisung handelt, und eine Zeichenfolge übergeben, die den Namen der Datenbanktabelle darstellt. Im Beispiel wird dann ein OracleCommandBuildererstellt.
Private Function SelectOracleRows(connection As String, queryString As String, tableName As String) As DataSet
Dim connection As New OracleConnection(connection)
Dim dataAdapter As New OracleDataAdapter()
Dim dataSet As DataSet = New DataSet
dataAdapter.SelectCommand = New OracleCommand(queryString, connection)
Dim cmdBuilder As OracleCommandBuilder = New OracleCommandBuilder(dataAdapter)
connection.Open()
dataAdapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
' Without the OracleCommandBuilder this line would fail.
dataAdapter.Update(dataSet, tableName)
connection.Close()
End Function
public static DataSet SelectOracleSrvRows(string myConnection, string mySelectQuery, string myTableName)
{
OracleConnection myConn = new OracleConnection(myConnection);
OracleDataAdapter myDataAdapter = new OracleDataAdapter();
myDataAdapter.SelectCommand = new OracleCommand(mySelectQuery, myConn);
OracleCommandBuilder cb = new OracleCommandBuilder(myDataAdapter);
myConn.Open();
DataSet ds = new DataSet();
myDataAdapter.Fill(ds, myTableName);
//Code to modify data in DataSet goes here...
//Without the OracleCommandBuilder this line would fail.
myDataAdapter.Update(ds, myTableName);
myConn.Close();
return ds;
}
Hinweise
Dieser Typ ist veraltet und wird in einer zukünftigen Version des .NET Framework entfernt. Weitere Informationen finden Sie unter Oracle und ADO.NET.
Die OracleDataAdapter generiert nicht automatisch die SQL-Anweisungen, die zum Abgleichen von Änderungen an einem DataSet der Datenbank zugeordneten erforderlich sind. Sie können jedoch ein OracleCommandBuilder -Objekt erstellen, das SQL-Anweisungen für Einzeltabellenupdates generiert, indem Sie die SelectCommand -Eigenschaft von OracleDataAdapterfestlegen. Anschließend werden alle zusätzlichen SQL-Anweisungen generiert, OracleCommandBuilder die Sie nicht festlegen.
Die Beziehung zwischen einem OracleDataAdapter und dem entsprechenden OracleCommandBuilder ist immer 1:1. Um diese Korrespondenz zu erstellen, legen Sie die OracleDataAdapter -Eigenschaft des OracleCommandBuilder -Objekts fest. Dies bewirkt, dass sich der OracleCommandBuilder als Listener registriert, wodurch die Ausgabe von RowUpdating Ereignissen erzeugt wird, die sich auf auswirken DataSet.
Zum Generieren von INSERT-, UPDATE- oder DELETE-Anweisungen verwendet die OracleCommandBuilderSelectCommand -Eigenschaft, um einen erforderlichen Satz von Metadaten abzurufen.
Verwendet OracleCommandBuilder auch die ConnectionEigenschaften , und , auf Transaction die SelectCommandvon verwiesen wird.
Wenn Sie aufrufen Dispose, wird die OracleCommandBuilder Zuordnung zu OracleDataAdapterdem getrennt, und die generierten Befehle werden nicht mehr verwendet.
Konstruktoren
| OracleCommandBuilder() |
Veraltet.
Initialisiert eine neue Instanz des OracleCommandBuilder. |
| OracleCommandBuilder(OracleDataAdapter) |
Veraltet.
Initialisiert eine neue Instanz der OracleCommandBuilder-Klasse mit dem zugeordneten OracleDataAdapter-Objekt. |
Eigenschaften
| CanRaiseEvents |
Veraltet.
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
| CatalogLocation |
Veraltet.
Ruft die CatalogLocation für eine Instanz der DbCommandBuilder-Klasse ab oder legt sie fest. |
| CatalogSeparator |
Veraltet.
Ruft eine Zeichenfolge als Katalogtrennzeichen für eine Instanz der DbCommandBuilder-Klasse ab oder legt sie fest. |
| ConflictOption |
Veraltet.
Gibt an, welche ConflictOption vom DbCommandBuilder verwendet werden muss. (Geerbt von DbCommandBuilder) |
| Container |
Veraltet.
Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component) |
| DataAdapter |
Veraltet.
Ruft ein OracleDataAdapter-Objekt ab, für das dieses OracleCommandBuilder-Objekt SQL-Anweisungen generiert, oder legt dieses fest. |
| DesignMode |
Veraltet.
Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component) |
| Events |
Veraltet.
Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component) |
| QuotePrefix |
Veraltet.
Ruft das oder die Anfangszeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest. |
| QuotePrefix |
Veraltet.
Ruft das oder die Anfangszeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest. (Geerbt von DbCommandBuilder) |
| QuoteSuffix |
Veraltet.
Ruft das oder die Endzeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest. |
| QuoteSuffix |
Veraltet.
Ruft das oder die Endzeichen ab, die beim Angeben von Datenbankobjekten (z. B. Tabellen oder Spalten) verwendet werden sollen, deren Namen Zeichen wie Leerzeichen oder reservierte Token enthalten, oder legt diese fest. (Geerbt von DbCommandBuilder) |
| SchemaSeparator |
Veraltet.
Ruft das als Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern zu verwendende Zeichen ab oder legt dieses fest. |
| SetAllValues |
Veraltet.
Gibt an, ob alle Spaltenwerte oder nur die geänderten in einer Aktualisierungsanweisung eingeschlossen sind. (Geerbt von DbCommandBuilder) |
| Site |
Veraltet.
Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component) |
Methoden
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Veraltet.
Ermöglicht es der Anbieterimplementierung der DbCommandBuilder-Klasse, zusätzliche Parametereigenschaften zu behandeln. (Geerbt von DbCommandBuilder) |
| CreateObjRef(Type) |
Veraltet.
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
| DeriveParameters(OracleCommand) |
Veraltet.
Ruft Parameterinformationen aus der im OracleCommand angegebenen gespeicherten Prozedur ab und füllt die Parameters-Auflistung des angegebenen OracleCommand-Objekts auf. |
| Dispose() |
Veraltet.
Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component) |
| Dispose(Boolean) |
Veraltet.
Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component) |
| Dispose(Boolean) |
Veraltet.
Gibt die von DbCommandBuilder verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbCommandBuilder) |
| Equals(Object) |
Veraltet.
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetDeleteCommand() |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für die Ausführung von Löschvorgängen in der Datenbank erforderlich ist. |
| GetDeleteCommand(Boolean) |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für die Ausführung von Löschvorgängen in der Datenbank erforderlich ist. |
| GetHashCode() |
Veraltet.
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetInsertCommand() |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist. |
| GetInsertCommand(Boolean) |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist. |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetParameterName(Int32) |
Veraltet.
Gibt den Namen des angegebenen Parameters im Format zurück |
| GetParameterName(String) |
Veraltet.
Gibt den vollständigen Parameternamen zurück, wenn der partielle Parameternamen angegeben ist. (Geerbt von DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Veraltet.
Gibt den Platzhalter für den Parameter in der zugeordneten SQL-Anweisung zurück. (Geerbt von DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Veraltet.
Gibt die Schematabelle für den DbCommandBuilder zurück. (Geerbt von DbCommandBuilder) |
| GetService(Type) |
Veraltet.
Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component) |
| GetType() |
Veraltet.
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUpdateCommand() |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist. |
| GetUpdateCommand(Boolean) |
Veraltet.
Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist. |
| InitializeCommand(DbCommand) |
Veraltet.
Legt die Eigenschaften CommandTimeout, Transaction, CommandType und UpdateRowSource für DbCommand erneut fest. (Geerbt von DbCommandBuilder) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Veraltet.
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Veraltet.
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
| QuoteIdentifier(String) |
Veraltet.
Bei einem Bezeichner ohne Anführungszeichen in der richtigen Katalogschreibweise wird die korrekte Form des jeweiligen Bezeichners mit Anführungszeichen zurückgegeben, einschließlich der ordnungsgemäßen Escapezeichen für ggf. vorhandene eingebettete Anführungszeichen im Bezeichner. |
| RefreshSchema() |
Veraltet.
Löscht die Befehle, die diesem DbCommandBuilder zugeordnet sind. |
| RefreshSchema() |
Veraltet.
Löscht die diesem DbCommandBuilder zugeordneten Befehle. (Geerbt von DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Veraltet.
Fügt einen Ereignishandler für das RowUpdating-Ereignis hinzu. (Geerbt von DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Veraltet.
Registriert den DbCommandBuilder zum Behandeln des RowUpdating-Ereignisses für einen DbDataAdapter. (Geerbt von DbCommandBuilder) |
| ToString() |
Veraltet.
Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component) |
| UnquoteIdentifier(String) |
Veraltet.
Bei einem Bezeichner mit Anführungszeichen wird die richtige Form des Bezeichners ohne Anführungszeichen zurückgegeben. Dies schließt ein, dass Escapezeichen für eingebettete Anführungszeichen im Bezeichner ordnungsgemäß entfernt werden. |
Ereignisse
| Disposed |
Veraltet.
Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component) |
