SqlParameterCollection 类

表示与 SqlCommand 相关联的参数的集合以及各个参数到 DataSet 中列的映射。无法继承此类。

**命名空间:**System.Data.SqlClient
**程序集:**System.Data(在 system.data.dll 中)

语法

声明
Public NotInheritable Class SqlParameterCollection
    Inherits DbParameterCollection
用法
Dim instance As SqlParameterCollection
public sealed class SqlParameterCollection : DbParameterCollection
public ref class SqlParameterCollection sealed : public DbParameterCollection
public final class SqlParameterCollection extends DbParameterCollection
public final class SqlParameterCollection extends DbParameterCollection

备注

如果命令中包含特殊 SQL 语句(而非存储过程名称),则集合中的参数数目必须等于命令文本内参数占位符的数目,否则 SQL Server 将引发错误。使用存储过程时,必须提供在存储过程中声明但没有默认值的所有参数。使用默认值声明的参数是可选的。这使您可以指定默认值以外的值。

示例

下面的示例通过 SqlParameterCollection 集合创建 SqlParameter 的多个实例。这些参数用于选择数据源内的数据,以及填充 DataSet。此代码假定已经用适当的架构、命令和连接创建了 DataSetSqlDataAdapter

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub  
public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}

继承层次结构

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameterCollection
      System.Data.SqlClient.SqlParameterCollection

线程安全

此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

SqlParameterCollection 成员
System.Data.SqlClient 命名空间

其他资源

在 ADO.NET 中连接和检索数据
使用 SQL Server .NET Framework 数据提供程序