SqlParameter コンストラクター

リファレンス

定義

名前空間:: System.Data.SqlClient

アセンブリ:: System.Data.SqlClient.dll

アセンブリ:: System.Data.dll

パッケージ:: System.Data.SqlClient v4.8.6

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 作成し、そのプロパティの一部を設定します。

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType)

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

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

パラメーター

parameterName: String

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

dbType: SqlDbType

SqlDbType 値のいずれか 1 つ。

例外

ArgumentException

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

例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

注釈

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

こちらもご覧ください

適用対象

SqlParameter(String, Object)

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

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter (string parameterName, object value);

new System.Data.SqlClient.SqlParameter : string * obj -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

パラメーター

parameterName: String

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

value: Object

SqlParameter の値である Object。

例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

注釈

パラメーターでを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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

パラメーター

parameterName: String

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

dbType: SqlDbType

SqlDbType 値のいずれか 1 つ。

size: Int32

パラメーターの長さ。

例外

ArgumentException

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

例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

注釈

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.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

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

例外

ArgumentException

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

例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

注釈

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.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 に対する呼び出しでこの SqlParameter が使用されている場合の、ソース列 (SourceColumn) の名前。

sourceVersion: DataRowVersion

DataRowVersion 値のいずれか 1 つ。

value: Object

SqlParameter の値である Object。

例外

ArgumentException

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

例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

注釈

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

こちらもご覧ください

適用対象

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.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

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

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 値からと precision がsize推論されます。

こちらもご覧ください

適用対象

SqlParameter コンストラクター

定義

オーバーロード

SqlParameter()

例

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

SqlParameter(String, Object)

パラメーター

例

注釈

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType, Int32, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

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

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

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

パラメーター

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース