SqlParameterCollection 类

定义

命名空间:: System.Data.SqlClient

程序集:: System.Data.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示与 a SqlCommand 及其各自映射到列中 DataSet的参数集合。此类不能被继承。

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

继承: Object

MarshalByRefObject
SqlParameterCollection

继承: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

属性: ListBindableAttribute

实现: ICollection IEnumerable IList IDataParameterCollection

示例

以下示例通过SqlParameterCollection集合创建多个实例SqlParameter。参数用于选择数据源中的数据并填充。DataSet 此代码假定已使用相应的架构、命令和连接创建 a DataSet 和 a SqlDataAdapter 。

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

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

注解

如果命令包含临时 SQL 语句，而不是存储过程名称，则集合中的参数数必须与命令文本中的参数占位符数相等，或SQL Server引发错误。使用存储过程时，必须提供未提供默认值的存储过程中声明的所有参数。使用默认值声明的参数是可选的。这样，可以指定默认值以外的值。

有关演示如何使用参数的其他示例代码的详细信息，请参阅命令和参数。

属性

名称	说明
Count	返回一个整数，该整数包含 . 中的 SqlParameterCollection元素数。只读。
IsFixedSize	获取一个值，该值指示是否 SqlParameterCollection 具有固定大小。
IsReadOnly	获取一个值，该值指示是否 SqlParameterCollection 为只读。
IsSynchronized	获取一个值，该值指示是否 SqlParameterCollection 同步。
Item[Int32]	获取 SqlParameter 指定索引处。
Item[String]	获取具有指定名称的 < a0/>。
SyncRoot	获取可用于同步对 . SqlParameterCollection的访问的对象。

方法

名称	说明
Add(Object)	将指定的SqlParameter对象添加到 .SqlParameterCollection
Add(SqlParameter)	将指定的SqlParameter对象添加到 .SqlParameterCollection
Add(String, Object)	已过时. 将指定的SqlParameter对象添加到 .SqlParameterCollection
Add(String, SqlDbType, Int32, String)	向参数名称、数据类型和列长度添加 a SqlParameter SqlParameterCollection 。
Add(String, SqlDbType, Int32)	在指定参数名称和SqlDbType大小的情况下，向 SqlParameterCollection添加一个SqlParameter。
Add(String, SqlDbType)	向给定的参数名称和数据类型添加 a SqlParameter SqlParameterCollection 。
AddRange(Array)	将值数组添加到值末尾 SqlParameterCollection。
AddRange(SqlParameter[])	将值数组 SqlParameter 添加到值末尾 SqlParameterCollection。
AddWithValue(String, Object)	向末尾 SqlParameterCollection添加一个值。
Clear()	从 .. 中删除所有 SqlParameter 对象 SqlParameterCollection。
Contains(Object)	确定指定的 Object 值是否在此中 SqlParameterCollection。
Contains(SqlParameter)	确定指定的 SqlParameter 值是否在此中 SqlParameterCollection。
Contains(String)	确定指定的参数名称是否在此中 SqlParameterCollection。
CopyTo(Array, Int32)	从指定的目标SqlParameterCollection索引处开始，将当前Array的所有元素复制到指定的一维Array。
CopyTo(SqlParameter[], Int32)	将当前 SqlParameterCollection 的所有元素复制到指定目标索引处的指定 SqlParameterCollection 元素。
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问的 SqlParameterCollection枚举数。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetParameter(Int32)	返回 DbParameter 集合中指定索引处的对象。 (继承自 DbParameterCollection)
GetParameter(String)	返回 DbParameter 具有指定名称的对象。 (继承自 DbParameterCollection)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(Object)	获取集合中指定的位置 Object 。
IndexOf(SqlParameter)	获取集合中指定的位置 SqlParameter 。
IndexOf(String)	获取具有指定名称的指定 SqlParameter 位置。
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
Insert(Int32, Object)	将 a Object SqlParameterCollection 插入到指定索引处。
Insert(Int32, SqlParameter)	将 SqlParameter 对象 SqlParameterCollection 插入指定索引处。
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
Remove(Object)	从集合中移除指定的 SqlParameter 值。
Remove(SqlParameter)	从集合中移除指定的 SqlParameter 值。
RemoveAt(Int32)	从SqlParameter SqlParameterCollection指定索引处删除该位置。
RemoveAt(String)	从SqlParameter SqlParameterCollection指定参数名称处删除该参数。
SetParameter(Int32, DbParameter)	将 DbParameter 指定索引处的对象设置为新值。 (继承自 DbParameterCollection)
SetParameter(String, DbParameter)	将 DbParameter 具有指定名称的对象设置为新值。 (继承自 DbParameterCollection)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

显式接口实现

名称	说明
IDataParameterCollection.Item[String]	获取或设置指定索引处的参数。 (继承自 DbParameterCollection)
IList.Item[Int32]	获取或设置指定索引处的元素。 (继承自 DbParameterCollection)

扩展方法

名称	说明
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。
Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。

适用于

另请参阅

反馈

此页面是否有帮助？