OracleDataAdapter.InsertCommand-Eigenschaft

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

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

Syntax

'Declaration
Public Property InsertCommand As OracleCommand
'Usage
Dim instance As OracleDataAdapter
Dim value As OracleCommand

value = instance.InsertCommand

instance.InsertCommand = value

public OracleCommand InsertCommand { get; set; }

public:
property OracleCommand^ InsertCommand {
    OracleCommand^ get ();
    void set (OracleCommand^ value);
}

/** @property */
public OracleCommand get_InsertCommand ()

/** @property */
public void set_InsertCommand (OracleCommand value)

public function get InsertCommand () : OracleCommand

public function set InsertCommand (value : OracleCommand)

Eigenschaftenwert

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

Hinweise

Wenn die InsertCommand-Eigenschaft einem bereits erstellten OracleCommand-Objekt zugewiesen ist, wird der OracleCommand nicht geklont. Stattdessen verwaltet InsertCommand einen Verweis auf den bereits erstellten OracleCommand.

Wenn InsertCommand bei einem Aktualisierungsvorgang nicht festgelegt ist und Primärschlüsselinformationen im DataSet vorhanden sind, können Sie mit der OracleCommandBuilder-Klasse automatisch InsertCommand und weitere Befehle zum Abstimmen des DataSet mit der Datenbank generieren. Legen Sie hierzu die SelectCommand-Eigenschaft des OracleDataAdapter fest. Für die Generierungslogik müssen außerdem im DataSet Schlüsselspalteninformationen vorhanden sein. Weitere Informationen finden Sie unter Automatisches Generieren von Befehlen.

Beispiel

Im folgenden Beispiel werden ein OracleDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die InsertCommand-Eigenschaft festgelegt. Es wird davon ausgegangen, dass bereits ein OracleConnection-Objekt erstellt wurde.

[Visual Basic]

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

[C#]

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;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OracleDataAdapter-Klasse
OracleDataAdapter-Member
System.Data.OracleClient-Namespace
OracleDataAdapter.DeleteCommand-Eigenschaft
SelectCommand
UpdateCommand