共用方式為


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 類別的新執行個體,其使用參數名稱、參數類型、參數長度、方向、有效位數、小數位數、來源資料行名稱、DataRowVersion 值的其中一個、來源資料行對應的布林值、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 值。

例外狀況

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

備註

資料類型,如果適當,則會從 參數的值 dbType 推斷和 大小Precision

適用於

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

Object,是 SqlParameter 的值。

範例

下列範例會建立 並 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);
    }
}

備註

當您在 value 參數中指定 Object 時, SqlDbType 會從 的 Microsoft .NET Framework 類型 Object 推斷 。

當您使用此建構函式的多 SqlParameter 載來指定整數參數值時,請小心。 由於這個多載接受 Object 型別的 value,因此您必須在值為零時將整數值轉換成 Object 型別,如下面的 C# 範例所示。

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

如果您未執行此轉換,編譯器會假設您嘗試呼叫 SqlParameter(String, SqlDbType) 建構函式多載。

適用於

SqlParameter(String, SqlDbType, Int32)

初始化 SqlParameter 類別的新執行個體,這個執行個體會使用參數名稱、SqlDbType 和此大小。

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 值。

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 明確設定,則會從 參數的值 dbType 推斷 Size。

適用於

SqlParameter(String, SqlDbType, Int32, String)

初始化 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 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 值。

size
Int32

參數的長度。

sourceColumn
String

如果 SqlParameter 呼叫 中使用 >Update(DataSet) 這個 ,則來源資料行的名稱 (SourceColumn) 。

例外狀況

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 明確設定,則會從 參數的值 dbType 推斷 Size。

適用於

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

初始化 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 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 值。

size
Int32

參數的長度。

direction
ParameterDirection

其中一個 ParameterDirection 值。

isNullable
Boolean

若欄位值可以是 Null,即為 true;否則為 false

precision
Byte

Value 所解析的小數點左右側的位數總數。

scale
Byte

Value 所解析的小數點位數的總數。

sourceColumn
String

如果在對 Update(DataSet) 的呼叫中使用這個 SqlParameter,則為來源資料行名稱 (SourceColumn)。

sourceVersion
DataRowVersion

其中一個 DataRowVersion 值。

value
Object

Object,是 SqlParameter 的值。

例外狀況

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 明確設定,則會從 參數的值 dbType 推斷 Size Precisionprecision

適用於

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

初始化 SqlParameter 類別的新執行個體,其使用參數名稱、參數類型、參數長度、方向、有效位數、小數位數、來源資料行名稱、DataRowVersion 值的其中一個、來源資料行對應的布林值、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 值。

size
Int32

參數的長度。

direction
ParameterDirection

其中一個 ParameterDirection 值。

precision
Byte

Value 所解析的小數點左右側的位數總數。

scale
Byte

Value 所解析的小數點位數的總數。

sourceColumn
String

如果 SqlParameter 呼叫 中使用 >Update(DataSet) 這個 ,則來源資料行的名稱 (SourceColumn) 。

sourceVersion
DataRowVersion

其中一個 DataRowVersion 值。

sourceColumnNullMapping
Boolean

如果來源資料行可為 Null,則為 true;否則為 false

value
Object

Object,是 SqlParameter 的值。

xmlSchemaCollectionDatabase
String

這個 XML 執行個體結構描述集合所在的資料庫名稱。

xmlSchemaCollectionOwningSchema
String

這個 XML 執行個體結構描述集合所在的主控關聯式結構描述。

xmlSchemaCollectionName
String

此參數的結構描述集合名稱。

備註

Size如果在 和 參數中 size 未明確設定,則會 Precision 從 參數的值 dbType 推斷 和 precision

適用於