SqlParameter クラス

リファレンス

定義

名前空間:: System.Data.SqlClient

アセンブリ:: System.Data.SqlClient.dll

アセンブリ:: System.Data.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

SqlCommand に対するパラメーター、および必要に応じてその DataSet 列へのマッピングを表します。このクラスは継承できません。パラメーターの詳細については、「パラメーターおよびパラメーターデータ型の構成」を参照してください。

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public ref class SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

継承: Object

DbParameter
SqlParameter

継承: Object

MarshalByRefObject

DbParameter
SqlParameter

継承: Object

MarshalByRefObject
SqlParameter

属性: TypeConverterAttribute

実装: ICloneable IDataParameter IDbDataParameter

例

次の例では、.. 内のコレクションを通じて複数のSqlParameterインスタンスをSqlParameterCollection SqlDataAdapter作成します。これらのパラメーターは、データソースからデータを選択し、データを DataSet. この例では、適切なスキーマ、コマンド、接続を使用して a DataSet と a SqlDataAdapter が既に作成されていることを前提としています。パラメーターの使用に関する詳細と追加の例については、「 ADO.NET でのデータの取得と変更」および「パラメーターとパラメーターのデータ型の構成」を参照してください。

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 Serverの.NET Framework Data Providerではサポートされていません。

詳細については、パラメーターの使用方法を示す追加のサンプルコードと共に、「コマンドとパラメーター」を参照してください。

コンストラクター

SqlParameter()	SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, Object)	新しい SqlParameter のパラメーター名および値を使用する SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType)	指定されたパラメーター名およびデータ型を使用する SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32)	パラメーター名、SqlDbType、およびサイズを使用する SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	パラメーター名、パラメーターの型、パラメーターのサイズ、ParameterDirection、パラメーターの有効桁数、パラメーターの小数点以下桁数、ソース列、使用する DataRowVersion、およびパラメーターの値を使用する SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	以下のものを使用する SqlParameter クラスの新しいインスタンスを初期化します。つまり、パラメーター名、パラメーターの型、パラメーターの長さ、方向、精度、位取り、ソース列の名前、DataRowVersion の値の 1 つ、ソース列マッピングのブール値、`SqlParameter` の値、この XML インスタンスのスキーマコレクションがあるデータベースの名前、この XML インスタンスのスキーマコレクションがある所有リレーショナルスキーマ、このパラメーターのスキーマコレクションの名前です。
SqlParameter(String, SqlDbType, Int32, String)	パラメーター名、SqlDbType、サイズ、およびソース列名を使用する SqlParameter クラスの新しいインスタンスを初期化します。

プロパティ

CompareInfo	このパラメーターについての文字列比較を実行する方法を定義する CompareInfo オブジェクトを取得または設定します。
DbType	パラメーターの SqlDbType を取得または設定します。
Direction	パラメーターが入力専用、出力専用、双方向、またはストアドプロシージャの戻り値パラメーターのいずれであるかを示す値を取得または設定します。
ForceColumnEncryption	[常に暗号化] を使用する場合、パラメーターの暗号化を強制的に適用します。パラメーターの暗号化が不要であることが SQL Server からドライバーに通知された場合、このパラメーターを使用するクエリは失敗します。攻撃を受けた SQL Server がクライアントに不正な暗号化メタデータを提供すると、データ漏えいが引き起こされる可能性がありますが、このプロパティは、そのようなセキュリティ攻撃に対する保護を強化します。
IsNullable	パラメーターが null 値を受け取るかどうかを示す値を取得または設定します。 IsNullable は、パラメーターの値の検証には使用されないため、コマンドを実行するときに null 値の送信や受信を妨げません。
LocaleId	特定の地域の規約や言語を決定するロケール識別子を取得または設定します。
Offset	Value プロパティへのオフセットを取得または設定します。
ParameterName	SqlParameter の名前を取得または設定します。
Precision	Value プロパティを表すために使用される最大桁数を取得または設定します。
Scale	Value が解決される、小数点以下の桁数を取得または設定します。
Size	列内のデータの最大サイズ (バイト) を取得または設定します。
SourceColumn	DataSet に割り当てられ、Value の読み込みまたは戻しに使用されるソース列の名前を取得または設定します。
SourceColumnNullMapping	ソース列が Null 許容かどうかを示す値を取得または設定します。これにより、SqlCommandBuilder で null 許容列の Update ステートメントを正しく生成できます。
SourceVersion	DataRowVersion の読み込み時に使用する Value を取得または設定します。
SourceVersion	DataRowVersion の読み込み時に使用する Value を取得または設定します。 (継承元 DbParameter)
SqlDbType	パラメーターの SqlDbType を取得または設定します。
SqlValue	パラメーターの値を SQL 型として取得または設定します。
TypeName	テーブル値パラメーターの型名を取得または設定します。
UdtTypeName	パラメーターとしてユーザー定義型を表す `string` を取得または設定します。
Value	パラメーターの値を取得または設定します。
XmlSchemaCollectionDatabase	この XML インスタンスのスキーマコレクションがあるデータベースの名前を取得します。
XmlSchemaCollectionName	この XML インスタンスのスキーマコレクションの名前を取得します。
XmlSchemaCollectionOwningSchema	この XML インスタンスのスキーマコレクションがある、所有リレーショナルスキーマ。

メソッド

CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	互換性のために残されています。対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	互換性のために残されています。このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ResetDbType()	この SqlParameter に関連付けられている型をリセットします。
ResetSqlDbType()	この SqlParameter に関連付けられている型をリセットします。
ToString()	ParameterName を表す文字列を取得します。

明示的なインターフェイスの実装

ICloneable.Clone()	このメンバーの詳細については、「Clone()」をご覧ください。
IDataParameter.SourceVersion	Value を読み込むときに使用する DataRowVersion を取得または設定します。 (継承元 DbParameter)
IDbDataParameter.Precision	数値パラメーターの精度を示します。 (継承元 DbParameter)
IDbDataParameter.Scale	このメンバーの詳細については、「Scale」をご覧ください。 (継承元 DbParameter)

適用対象