SqlCeParameterCollection.Add Method (String, Object)
パラメータの名前と値を指定して、SqlCeParameter を SqlCeParameterCollection に追加します。
名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文
'宣言
Public Function Add ( _
parameterName As String, _
value As Object _
) As SqlCeParameter
public SqlCeParameter Add (
string parameterName,
Object value
)
public:
SqlCeParameter^ Add (
String^ parameterName,
Object^ value
)
public SqlCeParameter Add (
String parameterName,
Object value
)
public function Add (
parameterName : String,
value : Object
) : SqlCeParameter
パラメータ
- parameterName
パラメータの名前。
- value
コレクションに追加する SqlCeParameter の Object 値。
戻り値
新しい SqlCeParameter オブジェクトへの参照。
例外
例外の種類 | 条件 |
---|---|
InvalidCastException | value パラメータで指定されたオブジェクトは、文字列に変換できません。これは、オブジェクトがプリミティブ型 (SqlDbType またはバイト配列) でない場合に発生することがあります。 |
解説
新しい SqlCeParameter オブジェクトの SqlDbType は、value パラメータの .NET Compact Framework 型から推論されません。新しい SqlCeParameter オブジェクトの Value プロパティには value パラメータを変換して取得した文字列が設定され、SqlDbType には SqlDbType.NChar が設定されます。
作成時にパラメータの SqlDbType を明示的に設定する場合は、他の Add メソッドのオーバーロードのいずれかを使用する必要があります。
例
SqlCeParameterCollection に新しい要素を追加する例を次に示します。この例では、SqlCeCommand が作成されていることを前提にしています。
cmd.Parameters.Add("@Description", "Beverages")
cmd.Parameters.Add("@Description", "Beverages");
スレッド セーフ
この型の public static (Visual Basic では Shared ) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
開発プラットフォーム
Windows Vista、Windows Mobile 5.0、Windows XP Professional with Service Pack 2 (SP2)、Windows Server 2003、Windows Mobile 2003 for Pocket PC、Windows CE 5.0
バージョン情報
.NET Framework および .NET Compact Framework
3.5 でサポート
.NET Framework
3.0 でサポート
.NET Compact Framework および .Net Framework
2.0 でサポート
参照
リファレンス
SqlCeParameterCollection Class
SqlCeParameterCollection Members
System.Data.SqlServerCe Namespace