SqlParameter 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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()
初始化 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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType)參數
- parameterName
- String
要對應的參數名稱。
例外狀況
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.SqlParameterPublic 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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer)參數
- parameterName
- String
要對應的參數名稱。
- 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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)參數
- parameterName
- String
要對應的參數名稱。
- 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.SqlParameterPublic 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
要對應的參數名稱。
- size
- Int32
參數的長度。
- direction
- ParameterDirection
其中一個 ParameterDirection 值。
- isNullable
- Boolean
若欄位值可以是 Null，即為 true；否則為 false。
- 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 Precision 和 precision 。
適用於
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.SqlParameterPublic 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
要對應的參數名稱。
- size
- Int32
參數的長度。
- direction
- ParameterDirection
其中一個 ParameterDirection 值。
- 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 。