Share via


sqlsrv_execute

Führt eine zuvor vorbereitete Anweisung aus. Informationen zur Vorbereitung einer Anweisung für die Ausführung finden Sie unter sqlsrv_prepare.

Hinweis

Diese Funktion eignet sich ideal dazu, eine vorbereitete Anweisung mehrmals mit jeweils verschiedenen Parameterwerten auszuführen. Weitere Informationen finden Sie unter Vorgehensweise: Mehrmaliges Ausführen einer Abfrage.

Syntax

sqlsrv_execute( resource $stmt)

Parameter

$stmt: Eine Ressource, welche die auszuführende Anweisung angibt. Weitere Informationen zum Erstellen einer Anweisungsressource finden Sie unter sqlsrv_prepare.

Rückgabewert

Ein boolescher Wert: true, wenn die Anweisung erfolgreich ausgeführt wurde. Andernfalls false.

Beispiel

Im folgenden Beispiel wird eine Anweisung ausgeführt, mit der ein Feld in der Sales.SalesOrderDetail-Tabelle der AdventureWorks-Datenbank aktualisiert wird. Im Beispiel wird davon ausgegangen, dass SQL Server und die AdventureWorks-Datenbank auf dem lokalen Computer installiert sind. Alle Ausgaben werden in die Konsole geschrieben, wenn das Beispiel über die Befehlszeile ausgeführt wird.

<?php
/*Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false)
{
     echo "Could not connect.\n";
     die( print_r( sqlsrv_errors(), true));
}

/* Set up the Transact-SQL query. */
$tsql = "UPDATE Sales.SalesOrderDetail 
         SET OrderQty = ( ?) 
         WHERE SalesOrderDetailID = ( ?)";

/* Set up the parameters array. Parameters correspond, in order, to
question marks in $tsql. */
$params = array( 5, 10);

/* Create the statement. */
$stmt = sqlsrv_prepare( $conn, $tsql, $params);
if( $stmt )
{
     echo "Statement prepared.\n";
}
else
{
     echo "Error in preparing statement.\n";
     die( print_r( sqlsrv_errors(), true));
}

/* Execute the statement. Display any errors that occur. */
if( sqlsrv_execute( $stmt))
{
      echo "Statement executed.\n";
}
else
{
     echo "Error in executing statement.\n";
     die( print_r( sqlsrv_errors(), true));
}

/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>

Siehe auch

Verweis

sqlsrv_query

Konzepte

Informationen zu den Codebeispielen in der Dokumentation

Weitere Ressourcen

API-Referenz (SQL Server-Treiber für PHP)
Entwurfsaspekte