Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (日本語) » Ultra Light - .NET プログラミング » Ultra Light .NET 2.0 API リファレンス » ULParameterCollection クラス » Add メソッド

 

Add(String, Object) メソッド

指定されたパラメータ名と値を使用して作成された新しい ULParameter をコレクションに追加します。

構文
Visual Basic
Public Function Add( _
   ByVal parameterName As String, _
   ByVal value As Object _
) As ULParameter
C#
public ULParameter Add(
   string  parameterName,
   object value
);
パラメータ
  • parameterName   パラメータの名前。名前のないパラメータの場合、この値に空の文字列 ("") または NULL 参照 (Visual Basic の Nothing) を使用します。Ultra Light.NET では、ULCommand はパラメータの名前を使用しません。

  • value   パラメータの値である System.Object。

戻り値

新しい ULParameter オブジェクト。

備考

コレクション内のすべてのパラメータは、位置パラメータとして扱われ、ULCommand.CommandText の疑問符のプレースホルダと同じ順序で指定する必要があります。たとえば、コレクション内の最初のパラメータは、SQL 文の最初の疑問符に対応し、コレクション内の 2 番目のパラメータは、SQL 文の 2 番目の疑問符に対応します。ULCommand.CommandText 内の疑問符の数は、少なくともコレクション内のパラメータの数と同じでなければなりません。パラメータが不足している場合は、NULL が代用されます。

定数 0 と 0.0 の特別な処理と、オーバロードされたメソッドの解決方法のため、このメソッドを使用するときは、定数値を型オブジェクトに明示的にキャストすることを強くおすすめします。

次のコードでは、値が 0 である ULParameter パラメータが cmd という ULCommand に追加されます。

' Visual Basic
cmd.Parameters.Add( "", CType( 0, Object ) )

// C#
cmd.Parameters.Add( "", (object)0 );
参照