OracleCommandBuilder OracleCommandBuilder OracleCommandBuilder OracleCommandBuilder Class

Definition

Warnung

Diese API ist jetzt veraltet.

Generiert automatisch Befehle für einzelne Tabellen, durch die an einem DataSet vorgenommene Änderungen mit der zugeordneten Datenbank abgeglichen werden.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class OracleCommandBuilder sealed : 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.DbCommandBuilder
type OracleCommandBuilder = class
    inherit DbCommandBuilder
Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder
Vererbung
Attribute

Beispiele

Im folgenden Beispiel werden OracleCommandzusammen mit OracleDataAdapter und OracleConnectionzum Auswählen von Zeilen aus einer Datenbank verwendet.The following example uses OracleCommand, along with OracleDataAdapter and OracleConnection, to select rows from a database. Dem Beispiel wird eine initialisierte DataSet, eine Verbindungs Zeichenfolge, eine Abfrage Zeichenfolge, die eine SQL SELECT-Anweisung ist, und eine Zeichenfolge, die den Namen der Datenbanktabelle ist,The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the database table. Im Beispiel wird dann ein OracleCommandBuildererstellt.The example then creates an OracleCommandBuilder.

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.This type is deprecated and will be removed in a future version of the .NET Framework. Weitere Informationen finden Sie unter Oracle und ADO.net.For more information, see Oracle and ADO.NET.

Der OracleDataAdapter generiert nicht automatisch die SQL-Anweisungen, die erforderlich DataSet sind, um Änderungen abzugleichen, die mit der Datenbank verknüpft wurden.The OracleDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet associated with the database. Sie können jedoch ein OracleCommandBuilder Objekt erstellen, das SQL-Anweisungen für Aktualisierungen in einer Tabelle generiert, indem Sie die SelectCommand - OracleDataAdapterEigenschaft von festlegen.However, you can create an OracleCommandBuilder object that generates SQL statements for single-table updates by setting the SelectCommand property of the OracleDataAdapter. Dann generiert alle OracleCommandBuilder zusätzlichen SQL-Anweisungen, die Sie nicht festlegen.Then, the OracleCommandBuilder generates any additional SQL statements that you do not set.

Die Beziehung zwischen einer OracleDataAdapter und der entsprechenden OracleCommandBuilder ist immer eins zu eins.The relationship between an OracleDataAdapter and its corresponding OracleCommandBuilder is always one-to-one. Um diese Entsprechung zu erstellen, legen OracleDataAdapter Sie die- OracleCommandBuilder Eigenschaft des-Objekts fest.To create this correspondence, you set the OracleDataAdapter property of the OracleCommandBuilder object. Dies bewirkt OracleCommandBuilder , dass sich selbst als Listener registriert, der die Ausgabe von RowUpdating Ereignissen erzeugt, die den DataSetbeeinflussen.This causes the OracleCommandBuilder to register itself as a listener, which produces the output of RowUpdating events that affect the DataSet.

Zum Generieren von INSERT-, Update-oder DELETE- OracleCommandBuilder Anweisungen SelectCommand verwendet die-Eigenschaft, um einen erforderlichen Satz von Metadaten abzurufen.To generate INSERT, UPDATE, or DELETE statements, the OracleCommandBuilder uses the SelectCommand property to retrieve a required set of metadata.

Der OracleCommandBuilder verwendet auch die ConnectionEigenschaften, Transactionund, auf die von verwiesen wird SelectCommand.The OracleCommandBuilder also uses the Connection, and Transaction properties referenced by the SelectCommand.

Wenn Sie aufzurufen Dispose, OracleCommandBuilder OracleDataAdapterwird die Zuordnung der aufgehoben, und die generierten Befehle werden nicht mehr verwendet.If you call Dispose, the OracleCommandBuilder is disassociated from the OracleDataAdapter, and the generated commands are no longer used.

Konstruktoren

OracleCommandBuilder() OracleCommandBuilder() OracleCommandBuilder() OracleCommandBuilder()

Initialisiert eine neue Instanz des OracleCommandBuilder.Initializes a new instance of the OracleCommandBuilder.

OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter)

Initialisiert eine neue Instanz der OracleCommandBuilder-Klasse mit dem zugeordneten OracleDataAdapter-Objekt.Initializes a new instance of the OracleCommandBuilder class with the associated OracleDataAdapter object.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CatalogLocation CatalogLocation CatalogLocation CatalogLocation

Legt die CatalogLocation für eine Instanz der DbCommandBuilder-Klasse fest oder ruft diese ab.Sets or gets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator CatalogSeparator CatalogSeparator CatalogSeparator

Legt eine Zeichenfolge als Katalogtrennzeichen für eine Instanz der DbCommandBuilder-Klasse fest oder ruft diese ab.Sets or gets a string used as the catalog separator for an instance of the DbCommandBuilder class.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DataAdapter DataAdapter DataAdapter DataAdapter

Ruft ein OracleDataAdapter-Objekt ab, für das dieses OracleCommandBuilder-Objekt SQL-Anweisungen generiert, oder legt dieses fest.Gets or sets an OracleDataAdapter object for which this OracleCommandBuilder object will generate SQL statements.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
QuotePrefix QuotePrefix QuotePrefix QuotePrefix

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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

QuoteSuffix QuoteSuffix QuoteSuffix QuoteSuffix

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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

SchemaSeparator SchemaSeparator SchemaSeparator SchemaSeparator

Ruft das als Trennzeichen zwischen dem Schemabezeichner und anderen Bezeichnern zu verwendende Zeichen ab oder legt dieses fest.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)

Methoden

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeriveParameters(OracleCommand) DeriveParameters(OracleCommand) DeriveParameters(OracleCommand) DeriveParameters(OracleCommand)

Ruft Parameterinformationen aus der im OracleCommand angegebenen gespeicherten Prozedur ab und füllt die Parameters-Auflistung des angegebenen OracleCommand-Objekts auf.Retrieves parameter information from the stored procedure specified in the OracleCommand and populates the Parameters collection of the specified OracleCommand object.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDeleteCommand() GetDeleteCommand() GetDeleteCommand() GetDeleteCommand()

Ruft das automatisch generierte OracleCommand-Objekt ab, das für die Ausführung von Löschvorgängen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean)

Ruft das automatisch generierte OracleCommand-Objekt ab, das für die Ausführung von Löschvorgängen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetInsertCommand() GetInsertCommand() GetInsertCommand() GetInsertCommand()

Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean)

Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUpdateCommand() GetUpdateCommand() GetUpdateCommand() GetUpdateCommand()

Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform updates on the database.

GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean)

Ruft das automatisch generierte OracleCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist.Gets the automatically generated OracleCommand object required to perform updates on the database.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String)

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.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema() RefreshSchema() RefreshSchema() RefreshSchema()

Löscht die Befehle, die diesem DbCommandBuilder zugeordnet sind.Clears the commands that are associated with this DbCommandBuilder.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)
UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String)

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.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch