SqlParameter类

表示 SqlCommand 的参数，也可以是它到 DataSet 列的映射。无法继承此类。

下表列出了由 SqlParameter 类型公开的成员。 

 公共构造函数 
  名称  说明  
   SqlParameter  已重载。初始化 SqlParameter 类的新实例。 
页首 
 公共属性 
  名称  说明  
  CompareInfo  获取或设置 CompareInfo 对象，该对象定义应如何为此参数执行字符串比较。 
   DbType  已重写。获取或设置参数的 SqlDbType。 
   Direction  已重写。获取或设置一个值，该值指示参数是只可输入、只可输出、双向还是存储过程返回值参数。 
   IsNullable  已重写。获取或设置一个值，该值指示参数是否接受空值。 
  LocaleId  获取或设置可确定特定区域的约定和语言的区域设置标识符。 
   Offset  获取或设置对 Value 属性的偏移量。 
   ParameterName  已重写。获取或设置 SqlParameter 的名称。 
   Precision  获取或设置用来表示 Value 属性的最大位数。 
   Scale  获取或设置 Value 解析为的小数位数。 
   Size  已重写。获取或设置列中数据的最大大小（以字节为单位）。 
   SourceColumn  已重写。获取或设置源列的名称，该源列映射到 DataSet 并用于加载或返回 Value 
  SourceColumnNullMapping  已重写。设置或获取一个值，该值指示源列是否可为空。这样 SqlCommandBuilder 便能够为可为空的列正确生成 Update 语句。 
   SourceVersion  已重写。获取或设置在加载 Value 时要使用的 DataRowVersion。 
   SqlDbType  获取或设置参数的 SqlDbType。 
  SqlValue  获取作为 SQL 类型的参数的值，或设置该值。 
  UdtTypeName  获取或设置一个 string，它将用户定义的类型表示为参数。 
   Value  已重写。获取或设置该参数的值。 
  XmlSchemaCollectionDatabase  获取此 XML 实例的架构集合所在的数据库的名称。 
  XmlSchemaCollectionName  获取用于此 XML 实例的架构集合的名称。 
  XmlSchemaCollectionOwningSchema  包含此 XML 实例的架构集合的关系架构。 
页首 
 公共方法 （请参见 受保护的方法 ） 
  名称  说明  
  CreateObjRef   创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 （从 MarshalByRefObject 继承。） 
   Equals   已重载。 确定两个 Object 实例是否相等。 （从 Object 继承。） 
   GetHashCode   用作特定类型的哈希函数。GetHashCode 适合在哈希算法和数据结构（如哈希表）中使用。 （从 Object 继承。） 
  GetLifetimeService   检索控制此实例的生存期策略的当前生存期服务对象。 （从 MarshalByRefObject 继承。） 
   GetType   获取当前实例的 Type。 （从 Object 继承。） 
  InitializeLifetimeService   获取控制此实例的生存期策略的生存期服务对象。 （从 MarshalByRefObject 继承。） 
    ReferenceEquals   确定指定的 Object 实例是否是相同的实例。 （从 Object 继承。） 
  ResetDbType  已重写。 重置与此 SqlParameter 关联的类型。  
  ResetSqlDbType  重置与此 SqlParameter 关联的类型。  
   ToString  已重写。 获取一个包含 ParameterName 的字符串。  
页首 
 受保护的方法 
  名称  说明  
   Finalize   允许 Object 在“垃圾回收”回收 Object 之前尝试释放资源并执行其他清理操作。 （从 Object 继承。） 
   MemberwiseClone   已重载。 （从 MarshalByRefObject 继承。）  
页首 
 显式接口实现 
  名称  说明  
    System.ICloneable.Clone  有关此成员的说明，请参见 Clone。  

下面的示例通过 SqlDataAdapter 中的 SqlParameterCollection 集合创建 SqlParameter 的多个实例。这些参数用于从数据源中选择数据并将数据放在 DataSet 中。此示例假定已经使用适当的架构、命令和连接创建了 DataSet 和 SqlDataAdapter。

view plain copy to clipboard print ?

1. public void AddSqlParameters()   
2. {  
3. // ...  
4. // create categoriesDataSet and categoriesAdapter  
5. // ...  
6.   
7.   categoriesAdapter.SelectCommand.Parameters.Add(  
8.     "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";  
9.   categoriesAdapter.SelectCommand.Parameters.Add(  
10.     "@SerialNum", SqlDbType.Int).Value = 239;  
11.   categoriesAdapter.Fill(categoriesDataSet);  
12.   
13. }  

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