SqlParameter コンストラクター

定義

名前空間:: System.Data.SqlClient

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

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

重要

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

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

オーバーロード

名前	説明
SqlParameter()	SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType)	パラメーター名とデータ型を使用する SqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, Object)	パラメーター名と新しいSqlParameterの値を使用するSqlParameter クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32)	パラメーター名、SqlParameter、およびサイズを使用するSqlDbType クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32, String)	パラメーター名、SqlParameter、サイズ、およびソース列名を使用するSqlDbType クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	パラメーター名、パラメーターの型、パラメーターのサイズ、SqlParameter、パラメーターの精度、パラメーターの小数点以下桁数、使用するParameterDirection、およびパラメーターの値を使用するDataRowVersion クラスの新しいインスタンスを初期化します。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	パラメーター名、パラメーターの型、パラメーターの長さ、方向、有効桁数、スケール、ソース列の名前、SqlParameter値の 1 つ、ソース列マッピングのブール値、DataRowVersionの値、この XML インスタンスのスキーマコレクションがあるデータベースの名前を使用する`SqlParameter` クラスの新しいインスタンスを初期化します。この XML インスタンスのスキーマコレクションがある所有リレーショナルスキーマと、このパラメーターのスキーマコレクションの名前。

SqlParameter()

ソース:: System.Data.SqlClient.notsupported.cs

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)

ソース:: System.Data.SqlClient.notsupported.cs

パラメーター名とデータ型を使用する 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

注釈

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

こちらもご覧ください

適用対象

SqlParameter(String, Object)

ソース:: System.Data.SqlClient.notsupported.cs

パラメーター名と新しい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

Objectの値であるSqlParameter。

例

次の例では、 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

注釈

Object パラメーターに value を指定すると、SqlDbType は Object のMicrosoft .NET型から推論されます。

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

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

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

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType, Int32)

ソース:: System.Data.SqlClient.notsupported.cs

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

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 は、dbType パラメーターで明示的に設定されていない場合、size パラメーターの値から推論されます。

こちらもご覧ください

適用対象

SqlParameter(String, SqlDbType, Int32, String)

ソース:: System.Data.SqlClient.notsupported.cs

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

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

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

例外

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 は、dbType パラメーターで明示的に設定されていない場合、size パラメーターの値から推論されます。

こちらもご覧ください

適用対象

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

ソース:: System.Data.SqlClient.notsupported.cs

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

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

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

precision: Byte

Valueが解決される小数点の左右の桁数の合計。

scale: Byte

Valueが解決される小数点以下の桁数の合計。

sourceColumn: String

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

sourceVersion: DataRowVersion

DataRowVersion値の 1 つ。

value: Object

Objectの値であるSqlParameter。

例外

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 は、dbTypeパラメーターとsize パラメーターで明示的に設定されていない場合、precision パラメーターの値から推論されます。

こちらもご覧ください

適用対象

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

ソース:: System.Data.SqlClient.notsupported.cs

パラメーター名、パラメーターの型、パラメーターの長さ、方向、有効桁数、スケール、ソース列の名前、SqlParameter値の 1 つ、ソース列マッピングのブール値、DataRowVersionの値、この XML インスタンスのスキーマコレクションがあるデータベースの名前を使用するSqlParameter クラスの新しいインスタンスを初期化します。この 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

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

sourceVersion: DataRowVersion

DataRowVersion値の 1 つ。

sourceColumnNullMapping: Boolean

true ソース列が null 許容の場合。そうでない場合は false します。

value: Object

Objectの値であるSqlParameter。

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

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

注釈

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

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?