Freigeben über


OracleDataAdapter.UpdateCommand-Eigenschaft

Ruft eine SQL-Anweisung oder eine gespeicherte Prozedur ab, um Datensätze in der Datenbank zu aktualisieren, oder legt diese fest.

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

Syntax

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

value = instance.UpdateCommand

instance.UpdateCommand = value
public OracleCommand UpdateCommand { get; set; }
public:
property OracleCommand^ UpdateCommand {
    OracleCommand^ get ();
    void set (OracleCommand^ value);
}
/** @property */
public OracleCommand get_UpdateCommand ()

/** @property */
public void set_UpdateCommand (OracleCommand value)
public function get UpdateCommand () : OracleCommand

public function set UpdateCommand (value : OracleCommand)

Eigenschaftenwert

Ein OracleCommand, mit dem bei einem Aktualisierungsvorgang die Datensätze in der Datenbank aktualisiert werden, die den geänderten Zeilen im DataSet entsprechen.

Hinweise

Wenn UpdateCommand einem zuvor erstellten OracleCommand zugeordnet wird, wird der OracleCommand nicht geklont. Stattdessen verwaltet UpdateCommand einen Verweis auf das bereits erstellte OracleCommand-Objekt.

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.

Hinweis

Wenn durch die Ausführung dieses Befehls Zeilen zurückgegeben werden, können diese mit dem DataSet zusammengeführt werden. Dies ist davon abhängig, wie Sie die .Data.OracleClient.OracleCommand.UpdatedRowSource-Eigenschaft des OracleCommand-Objekts festlegen.

Beispiel

Im folgenden Beispiel werden ein OracleDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die UpdateCommand-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
  Dim parm As OracleParameter

  ' 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 UpdateCommand.

  cmd = New OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " & _
                       "WHERE DeptNo = poldDeptNo", conn)

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

  parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo")
  parm.SourceVersion = DataRowVersion.Original

  da.UpdateCommand = cmd

  Return da
End Function

[C#]

public static OracleDataAdapter CreateCustomerAdapter(OracleConnection conn)
{
  OracleDataAdapter da = new OracleDataAdapter();
  OracleCommand cmd;
  OracleParameter parm;

  // 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 UpdateCommand.

  cmd = new OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " +
                       "WHERE DeptNo = poldDeptNo", conn);

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

  parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo");
  parm.SourceVersion = DataRowVersion.Original;

  da.UpdateCommand = 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
OracleDataAdapter.InsertCommand-Eigenschaft
OracleDataAdapter.SelectCommand-Eigenschaft