SqlParameter コンストラクター

定義

オーバーロード

SqlParameter()

SqlParameter クラスの新しいインスタンスを初期化します。

SqlParameter(String, SqlDbType)

指定されたパラメーター名およびデータ型を使用する SqlParameter クラスの新しいインスタンスを初期化します。

SqlParameter(String, Object)

新しい SqlParameter のパラメーター名および値を使用する SqlParameter クラスの新しいインスタンスを初期化します。

SqlParameter(String, SqlDbType, Int32)

パラメーター名、SqlDbType、およびサイズを使用する SqlParameter クラスの新しいインスタンスを初期化します。

SqlParameter(String, SqlDbType, Int32, String)

パラメーター名、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()

SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter();
public SqlParameter ();
Public Sub New ()

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter();
        parameter.ParameterName = "@Description";
        parameter.IsNullable = true;
        parameter.SqlDbType = SqlDbType.VarChar;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;

        command.Parameters.Add(parameter);
    }
}

適用対象

SqlParameter(String, SqlDbType)

指定されたパラメーター名およびデータ型を使用する SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)

パラメーター

parameterName
String

マップするパラメーターの名前。

dbType
SqlDbType

SqlDbType 値のいずれか 1 つ。

例外

dbType パラメーターの指定された値が、正しくないバックエンド データ型です。

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command, string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

注釈

データ型と (必要に応じて ) SizePrecision は、 パラメーターの dbType 値から推論されます。

適用対象

SqlParameter(String, Object)

新しい SqlParameter のパラメーター名および値を使用する SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);
public SqlParameter (string parameterName, object value);
new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, value As Object)

パラメーター

parameterName
String

マップするパラメーターの名前。

value
Object

SqlParameter の値である Object

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

注釈

パラメーターで をObjectvalue指定すると、 SqlDbType の Microsoft .NET Framework 型から がObject推論されます。

コンストラクターのこのオーバーロードを使用して整数パラメーター値を SqlParameter 指定する場合は注意が必要です。 このオーバーロードは Object 型の value を受け取るため、次の C# の例のように、値が 0 の場合に整数値を Object 型に変換する必要があります。

Parameter = new SqlParameter("@pname", (object)0);  

この変換を実行しない場合、コンパイラはコンストラクター オーバーロードを呼び出 SqlParameter(String, SqlDbType) そうとしていることを前提としています。

適用対象

SqlParameter(String, SqlDbType, Int32)

パラメーター名、SqlDbType、およびサイズを使用する SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

パラメーター

parameterName
String

マップするパラメーターの名前。

dbType
SqlDbType

SqlDbType 値のいずれか 1 つ。

size
Int32

パラメーターの長さ。

例外

dbType パラメーターの指定された値が、正しくないバックエンド データ型です。

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command,
        string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

注釈

Size は、パラメーターで明示的に設定sizeされていない場合、パラメーターのdbType値から推論されます。

適用対象

SqlParameter(String, SqlDbType, Int32, String)

パラメーター名、SqlDbType、サイズ、およびソース列名を使用する SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

パラメーター

parameterName
String

マップするパラメーターの名前。

dbType
SqlDbType

SqlDbType 値のいずれか 1 つ。

size
Int32

パラメーターの長さ。

sourceColumn
String

ソース列 (SourceColumn) の呼び出しでこれが SqlParameter 使用されている場合の Update(DataSet)>名前。

例外

dbType パラメーターの指定された値が、正しくないバックエンド データ型です。

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

注釈

Size は、パラメーターで明示的に設定sizeされていない場合、パラメーターのdbType値から推論されます。

適用対象

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

パラメーター名、パラメーターの型、パラメーターのサイズ、ParameterDirection、パラメーターの有効桁数、パラメーターの小数点以下桁数、ソース列、使用する DataRowVersion、およびパラメーターの値を使用する SqlParameter クラスの新しいインスタンスを初期化します。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)

パラメーター

parameterName
String

マップするパラメーターの名前。

dbType
SqlDbType

SqlDbType 値のいずれか 1 つ。

size
Int32

パラメーターの長さ。

direction
ParameterDirection

ParameterDirection 値のいずれか 1 つ。

isNullable
Boolean

フィールドの値を null に設定できる場合は true。それ以外の場合は false

precision
Byte

Value を解決する際の、小数点の左側および右側の桁数の合計。

scale
Byte

Value を解決する際の、小数点以下の合計桁数。

sourceColumn
String

Update(DataSet) に対する呼び出しでこの SqlParameter が使用されている場合の、ソース列 (SourceColumn) の名前。

sourceVersion
DataRowVersion

DataRowVersion 値のいずれか 1 つ。

value
Object

SqlParameter の値である Object

例外

dbType パラメーターの指定された値が、正しくないバックエンド データ型です。

次の例では、 を SqlParameter 作成し、そのプロパティの一部を設定します。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 11, ParameterDirection.Input,
            true, 0, 0, "Description", DataRowVersion.Current,
            "garden hose");
        parameter.IsNullable = true;

        command.Parameters.Add(parameter);
    }
}

注釈

Size と は、 Precision パラメーターと precision パラメーターで明示的に設定されていない場合、パラメーターのsizedbTypeから推論されます。

適用対象

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

以下のものを使用する SqlParameter クラスの新しいインスタンスを初期化します。つまり、パラメーター名、パラメーターの型、パラメーターの長さ、方向、精度、位取り、ソース列の名前、DataRowVersion の値の 1 つ、ソース列マッピングのブール値、SqlParameter の値、この XML インスタンスのスキーマ コレクションがあるデータベースの名前、この XML インスタンスのスキーマ コレクションがある所有リレーショナル スキーマ、このパラメーターのスキーマ コレクションの名前です。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)

パラメーター

parameterName
String

マップするパラメーターの名前。

dbType
SqlDbType

SqlDbType 値のいずれか 1 つ。

size
Int32

パラメーターの長さ。

direction
ParameterDirection

ParameterDirection 値のいずれか 1 つ。

precision
Byte

Value を解決する際の、小数点の左側および右側の桁数の合計。

scale
Byte

Value を解決する際の、小数点以下の合計桁数。

sourceColumn
String

ソース列 (SourceColumn) の呼び出しでこれが SqlParameter 使用されている場合の Update(DataSet)>名前。

sourceVersion
DataRowVersion

DataRowVersion 値のいずれか 1 つ。

sourceColumnNullMapping
Boolean

ソース列が null 許容である場合は true。null 許容ではない場合は false

value
Object

SqlParameter の値である Object

xmlSchemaCollectionDatabase
String

この XML インスタンスのスキーマ コレクションがあるデータベースの名前。

xmlSchemaCollectionOwningSchema
String

この XML インスタンスのスキーマ コレクションがある、所有リレーショナル スキーマ。

xmlSchemaCollectionName
String

このパラメーターのスキーマ コレクションの名前。

注釈

Sizeパラメーターと Precision パラメーターに明示的に設定されていない場合、パラメーターの dbType 値から と precisionsize推論されます。

適用対象