SqlParameter クラス

定義

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

public ref class SqlParameter sealed : System::Data::Common::DbParameter
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : 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(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, 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
type SqlParameter = class
    inherit DbParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
継承
SqlParameter
継承
継承
SqlParameter
属性
実装

次の例では、 内の 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 ではサポートされていません。

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

コンストラクター

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)

適用対象

こちらもご覧ください