BindByName

このプロパティは、パラメータ・コレクションに使用されるバインディング・メソッドが名前別のバインドか、特定のOracleConnectionオブジェクトの位置別のバインドかを指定します。

宣言

// C#
public bool BindByName { get; set;}

プロパティ・タイプ

System.Boolean

プロパティ値

パラメータが名前別にバインドされる場合はtrueを戻し、位置別にバインドされる場合はfalseを戻します。

例外

System.ObjectDisposedException - OracleConnectionオブジェクトがすでに破棄されている場合は、このプロパティにアクセスできません。

備考

デフォルト値はfalseです。

次の条件の場合、BindByNameは無視されます。

XmlCommandTypeプロパティの値が、Insert、UpdateまたはDeleteの場合
XmlCommandTypeプロパティの値がQueryであるが、OracleCommandにパラメータが設定されていない場合

OracleCommand XmlCommandTypeプロパティがOracleXmlCommandType.Queryで、任意のパラメータがOracleCommandで設定されている場合は、そのBindByNameプロパティをtrueに設定する必要があります。そうでない場合は、次のOracleCommandメソッドでInvalidOperationExceptionがスローされます。

ExecuteNonQuery
ExecuteXmlReader
ExecuteStream
ExecuteToStream

BindByNameプロパティは、OracleCommand、OracleConnectionおよびOracleConfigurationオブジェクトで構成できます。デフォルトでは、OracleConnection BindByNameプロパティ値は構成時にOracleConfiguration BindByNameプロパティ値を継承し、OracleCommand BindByNameプロパティ値は構成時にOracleConnection BindByNameプロパティ値を継承します。OracleCommand BindByNameの値は、コマンド実行時のバインディング・メソッドを決定するために使用されます。