SqlParameter クラス

.NET Framework クラス ライブラリ リファレンス

SqlParameter クラス

SqlCommand のパラメータと、オプションで DataSet 列に対するマップを表します。このクラスは継承できません。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SqlParameter
    Inherits DbParameter
    Implements IDbDataParameter, IDataParameter, ICloneable

Visual Basic (使用法)

Dim instance As SqlParameter

C#

public sealed class SqlParameter : DbParameter,
 IDbDataParameter, IDataParameter, ICloneable

C++

public ref class SqlParameter sealed : public
 DbParameter, IDbDataParameter, IDataParameter, ICloneable

J#

public final class SqlParameter extends DbParameter
 implements IDbDataParameter, IDataParameter, 
    ICloneable

JScript

public final class SqlParameter extends
 DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable

解説

パラメータ名では大文字と小文字が区別されません。

使用例

SqlDataAdapter の SqlParameterCollection コレクションを使用して、SqlParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータは、データ ソースからのデータの選択と、DataSet へのデータの設定に使用されます。この例は、DataSet および SqlDataAdapter が、正しいスキーマ、コマンド、および接続で既に作成されていることを前提にしています。

Visual Basic

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  

C#

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.DbParameter
      System.Data.SqlClient.SqlParameter

スレッド セーフ

この型の public static (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

参照

関連項目
SqlParameter メンバ
System.Data.SqlClient 名前空間
SqlParameterCollection
SqlCommand クラス