BindByName

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

宣言

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

プロパティ・タイプ

System.Boolean

プロパティ値

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

例外

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

備考

デフォルト値はfalseです。

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

  • XmlCommandTypeプロパティの値が、InsertUpdateまたはDeleteの場合

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

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

  • ExecuteNonQuery

  • ExecuteXmlReader

  • ExecuteStream

  • ExecuteToStream

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