OracleDataAdapter.InsertCommand Eigenschaft

Definition

Ruft eine SQL-Anweisung oder eine gespeicherte Prozedur ab, mit der neue Datensätze in die Datenbank eingefügt werden, oder legt diese fest.

public:
 property System::Data::OracleClient::OracleCommand ^ InsertCommand { System::Data::OracleClient::OracleCommand ^ get(); void set(System::Data::OracleClient::OracleCommand ^ value); };
public System.Data.OracleClient.OracleCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.OracleClient.OracleCommand with get, set
Public Property InsertCommand As OracleCommand

Eigenschaftswert

Ein OracleCommand, mit dem bei einem Aktualisierungsvorgang die Datensätze in die Datenbank eingefügt werden, die den neuen Zeilen im DataSet entsprechen.

Beispiele

Im folgenden Beispiel wird ein OracleDataAdapter erstellt und die SelectCommand Eigenschaften und InsertCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OracleConnection Objekt erstellt haben.

Public Shared Function CreateCustomerAdapter(conn As OracleConnection) As OracleDataAdapter   

  Dim da As OracleDataAdapter = New OracleDataAdapter()  
  Dim cmd As OracleCommand  

  ' Create the SelectCommand.  

  cmd = New OracleCommand("SELECT * FROM Dept " & _  
                       "WHERE DName = :pDName AND Loc = :pLoc", conn)  

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14)  
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13)  

  da.SelectCommand = cmd  

  ' Create the InsertCommand.  

  cmd = New OracleCommand("INSERT INTO Dept (DeptNo, DName) " & _  
                       "VALUES (:pDeptNo, :pDName)", conn)  

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo")  
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName")  

  da.InsertCommand = cmd  

  Return da  
End Function  
public static OracleDataAdapter CreateCustomerAdapter(OracleConnection conn)  
{  
  OracleDataAdapter da = new OracleDataAdapter();  
  OracleCommand cmd;  

  // Create the SelectCommand.  

  cmd = new OracleCommand("SELECT * FROM Dept " +  
                       "WHERE DName = :pDName AND Loc = :pLoc", conn);  

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14);  
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13);  

  da.SelectCommand = cmd;  

  // Create the InsertCommand.  

  cmd = new OracleCommand("INSERT INTO Dept (DeptNo, DName) " +  
                       "VALUES (:pDeptNo, :pDName)", conn);  

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo");  
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName");  

  da.InsertCommand = cmd;  

  return da;  
}  

Hinweise

Wenn die InsertCommand -Eigenschaft einem zuvor erstellten OracleCommand Objekt zugewiesen wird, wird das OracleCommand nicht geklont. Verwaltet InsertCommand stattdessen einen Verweis auf das zuvor erstellte OracleCommand.

Wenn InsertCommand während eines Aktualisierungsvorgangs nicht festgelegt ist und Primärschlüsselinformationen in DataSetvorhanden sind, können Sie die OracleCommandBuilder -Klasse verwenden, um automatisch zu generieren und zusätzliche Befehle zu generieren InsertCommand, die zum Abgleichen von mit der DataSet Datenbank erforderlich sind. Legen Sie hierzu die SelectCommand -Eigenschaft von OracleDataAdapterfest. Die Generierungslogik erfordert auch schlüsselspaltene Informationen, die in DataSetvorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Hinweis

Wenn die Ausführung dieses Befehls Zeilen zurückgibt, können diese Zeilen dem DataSet hinzugefügt werden, je nachdem, wie Sie die UpdatedRowSource Eigenschaft des OracleCommand Objekts festlegen.

Wenn Sie eine Spalte mit dem LONG RAW Datentyp aktualisieren, wird eine Ausnahme ausgelöst, wenn Sie einen Wert von NULL in die Spalte eingeben. Der Oracle-Datentyp LONG RAW ist ein veralteter Typ in Oracle Version 8.0. Um diesen Fehler zu vermeiden, verwenden Sie den BLOB Datentyp anstelle von LONG RAW.

Gilt für:

Weitere Informationen