SqlParameter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SqlCommand に対するパラメーター、および必要に応じてその DataSet 列へのマッピングを表します。 このクラスは継承できません。 パラメーターの詳細については、「パラメーターおよびパラメーター データ型の構成」を参照してください。
public ref class SqlParameter sealed : System::Data::Common::DbParameterpublic ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameterpublic ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneablepublic 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(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneablepublic sealed class SqlParameter : System.Data.Common.DbParameter, ICloneabletype 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 ICloneabletype SqlParameter = class
inherit DbParameter
interface ICloneablePublic NotInheritable Class SqlParameter
Inherits DbParameterPublic NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameterPublic NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable- 継承
- 継承
- 継承
- 属性
- 実装
例
次の例では、 内の SqlParameter コレクションを介して の SqlParameterCollection 複数のインスタンスを作成します SqlDataAdapter。 これらのパラメーターは、データ ソースからデータを選択し、 にデータを配置するために使用されます DataSet。 この例では、 DataSet 適切なスキーマ、コマンド、接続を 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
注釈
パラメーター名の大文字と小文字は区別されません。
注意
名前なし (序数とも呼ばれます) パラメーターは、.NET Framework Data Provider for SQL Server ではサポートされていません。
パラメーターの使用方法を示す追加のサンプル コードと共に、詳細については、「 コマンドとパラメーター」を参照してください。
コンストラクター
プロパティ
| 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 | |
| SourceColumnNullMapping |
ソース列が Null 許容かどうかを示す値を取得または設定します。 これにより、SqlCommandBuilder で null 許容列の Update ステートメントを正しく生成できます。 |
| SourceVersion |
DataRowVersion の読み込み時に使用する Value を取得または設定します。 |
| SourceVersion |
DataRowVersion の読み込み時に使用する Value を取得または設定します。 (継承元 DbParameter) |
| SqlDbType |
パラメーターの SqlDbType を取得または設定します。 |
| SqlValue |
パラメーターの値を SQL 型として取得または設定します。 |
| TypeName |
テーブル値パラメーターの型名を取得または設定します。 |
| UdtTypeName |
パラメーターとしてユーザー定義型を表す |
| 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) |
適用対象
こちらもご覧ください
.NET