SqlParameterCollection 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示与 SqlCommand 关联的参数的集合以及各个参数到 DataSet 中列的映射。 此类不能被继承。
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollectionpublic ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollectionpublic sealed class SqlParameterCollection : 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.DbParameterCollectiontype SqlParameterCollection = class
inherit 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 DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList- 继承
- 继承
- 继承
- 属性
- 实现
示例
以下示例通过 SqlParameterCollection 集合创建 的SqlParameter多个实例。 参数用于选择数据源中的数据并填充 DataSet。 此代码假定 DataSet 已使用适当的架构、命令和连接创建了 和 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 是否具有固定大小。 |
| IsFixedSize |
指定集合是否为固定大小。 (继承自 DbParameterCollection) |
| IsReadOnly |
获取一个值，该值指示 SqlParameterCollection 是否为只读。 |
| IsReadOnly |
指定集合是否为只读。 (继承自 DbParameterCollection) |
| IsSynchronized |
获取一个值，该值指示 SqlParameterCollection 是否已同步。 |
| IsSynchronized |
指定是否同步集合。 (继承自 DbParameterCollection) |
| Item[Int32] |
获取位于指定索引处的 SqlParameter。 |
| Item[String] |
获取具有指定名称的 SqlParameter。 |
| SyncRoot |
获取可用于同步对 SqlParameterCollection 的访问的对象。 |
方法
显式接口实现
| ICollection.IsSynchronized |
获取一个值，该值指示是否同步对 ICollection 的访问（线程安全）。 (继承自 DbParameterCollection) |
| IDataParameterCollection.Item[String] |
获取或设置指定索引处的参数。 (继承自 DbParameterCollection) |
| IList.IsFixedSize |
获取一个值，该值指示 IList 是否具有固定大小。 (继承自 DbParameterCollection) |
| IList.IsReadOnly |
获取一个值，该值指示 IList 是否为只读。 (继承自 DbParameterCollection) |
| IList.Item[Int32] |
获取或设置指定索引处的元素。 (继承自 DbParameterCollection) |
扩展方法
| Cast<TResult>(IEnumerable) |
将 IEnumerable 的元素强制转换为指定的类型。 |
| OfType<TResult>(IEnumerable) |
根据指定类型筛选 IEnumerable 的元素。 |
| AsParallel(IEnumerable) |
启用查询的并行化。 |
| AsQueryable(IEnumerable) |
将 IEnumerable 转换为 IQueryable。 |
