sqlsrv_send_stream_data

下载 PHP 驱动程序

将数据从参数流发送至服务器。 每次调用 sqlsrv_send_stream_data 时,最多可以发送八千字节 (8K) 的数据。

注意

默认情况下,当执行查询时,所有流数据都将发送到服务器。 如果未更改此默认行为,则无需使用 sqlsrv_send_stream_data 来向服务器发送流数据。 有关更改默认行为的信息,请参阅 sqlsrv_querysqlsrv_prepare的“参数”部分。

语法

  
sqlsrv_send_stream_data( resource $stmt)  

参数

$stmt:对应于已执行语句的语句资源。

返回值

布尔:如果有更多数据需要发送,则为 true 。 否则为 false

示例

下面的示例将以流的形式打开产品评论,并将其发送到服务器。 禁用执行时发送所有流数据的默认行为。 该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。 从命令行运行该示例时,所有输出都将写入控制台。

<?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));  
}  
  
/* Define the query. */  
$tsql = "UPDATE Production.ProductReview   
         SET Comments = (?)   
         WHERE ProductReviewID = 3";  
  
/* Open parameter data as a stream and put it in the $params array. */
$data = 'Insert any lengthy comment here.';
$comment = fopen('data:text/plain,'.urlencode($data), 'r');
$params = array(&$comment);
  
/* Prepare the statement. Use the $options array to turn off the  
default behavior, which is to send all stream data at the time of query  
execution. */  
$options = array("SendStreamParamsAtExec"=>0);  
$stmt = sqlsrv_prepare($conn, $tsql, $params, $options);
  
/* Execute the statement. */  
sqlsrv_execute( $stmt);  
  
/* Send up to 8K of parameter data to the server with each call to  
sqlsrv_send_stream_data. Count the calls. */  
$i = 1;  
while (sqlsrv_send_stream_data($stmt)) {
      echo "$i call(s) made.\n";  
      $i++;  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

另请参阅

SQLSRV 驱动程序 API 参考

更新数据 (Microsoft Drivers for PHP for SQL Server)

文档中相关的代码示例