SqlParameter Konstruktor
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| SqlParameter() |
Menginisialisasi instans baru kelas SqlParameter. |
| SqlParameter(String, SqlDbType) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan jenis data. |
| SqlParameter(String, Object) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan nilai baru SqlParameter. |
| SqlParameter(String, SqlDbType, Int32) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, dan ukurannya. |
| SqlParameter(String, SqlDbType, Int32, String) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, ukuran, dan nama kolom sumber. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, ukuran parameter, ParameterDirection, presisi parameter, skala parameter, kolom sumber, DataRowVersion untuk digunakan, dan nilai parameter. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, panjang parameter arah, presisi, skala, nama kolom sumber, salah DataRowVersion satu nilai, Boolean untuk pemetaan kolom sumber, nilai |
SqlParameter()
Menginisialisasi instans baru kelas SqlParameter.
public:
SqlParameter();public SqlParameter ();Public Sub New ()Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Berlaku untuk
SqlParameter(String, SqlDbType)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan jenis data.
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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
Pengecualian
Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.
Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Keterangan
Jenis data dan, jika sesuai, Ukuran dan Precision disimpulkan dari nilai dbType parameter.
Berlaku untuk
SqlParameter(String, Object)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan nilai baru 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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
- value
- Object
Yang Object merupakan nilai dari SqlParameter.
Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Keterangan
Saat Anda menentukan Object dalam parameter, SqlDbType disimpulkan dari microsoft .NET Framework jenis Objectvalue .
Berhati-hatilah saat Anda menggunakan kelebihan beban SqlParameter konstruktor ini untuk menentukan nilai parameter bilangan bulat. Karena kelebihan beban ini mengambil value jenis Object, Anda harus mengonversi nilai integral menjadi Object jenis ketika nilainya nol, seperti yang ditunjukkan contoh C# berikut.
Parameter = new SqlParameter("@pname", (object)0);
Jika Anda tidak melakukan konversi ini, pengkompilasi mengasumsikan bahwa Anda mencoba memanggil SqlParameter(String, SqlDbType) overload konstruktor.
Berlaku untuk
SqlParameter(String, SqlDbType, Int32)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, dan ukurannya.
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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
- size
- Int32
Panjang parameter.
Pengecualian
Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.
Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Keterangan
Ukuran disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter .
Berlaku untuk
SqlParameter(String, SqlDbType, Int32, String)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, ukuran, dan nama kolom sumber.
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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
- size
- Int32
Panjang parameter.
- sourceColumn
- String
Nama kolom sumber (SourceColumn) jika ini SqlParameter digunakan dalam panggilan ke Update(DataSet)>.
Pengecualian
Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.
Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Keterangan
Ukuran disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter .
Berlaku untuk
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, ukuran parameter, ParameterDirection, presisi parameter, skala parameter, kolom sumber, DataRowVersion untuk digunakan, dan nilai parameter.
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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
- size
- Int32
Panjang parameter.
- direction
- ParameterDirection
Salah ParameterDirection satu nilai.
- isNullable
- Boolean
true jika nilai bidang bisa null; jika tidak, false.
- sourceColumn
- String
Nama kolom sumber (SourceColumn) jika ini SqlParameter digunakan dalam panggilan ke Update(DataSet).
- sourceVersion
- DataRowVersion
Salah DataRowVersion satu nilai.
- value
- Object
Yang Object merupakan nilai dari SqlParameter.
Pengecualian
Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.
Contoh
Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.
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);
}
}
Keterangan
Ukuran dan Precision disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter dan precision .
Berlaku untuk
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, panjang parameter arah, presisi, skala, nama kolom sumber, salah DataRowVersion satu nilai, Boolean untuk pemetaan kolom sumber, nilai SqlParameter, nama database tempat koleksi skema untuk instans XML ini berada, skema relasional pemilik tempat koleksi skema untuk instans XML ini berada, dan nama koleksi skema untuk parameter ini.
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)Parameter
- parameterName
- String
Nama parameter yang akan dipetakan.
- size
- Int32
Panjang parameter.
- direction
- ParameterDirection
Salah ParameterDirection satu nilai.
- sourceColumn
- String
Nama kolom sumber (SourceColumn) jika ini SqlParameter digunakan dalam panggilan ke Update(DataSet)>.
- sourceVersion
- DataRowVersion
Salah DataRowVersion satu nilai.
- sourceColumnNullMapping
- Boolean
true jika kolom sumber dapat diubah ke null; false jika tidak.
- value
- Object
Yang Object merupakan nilai dari SqlParameter.
- xmlSchemaCollectionDatabase
- String
Nama database tempat kumpulan skema untuk instans XML ini berada.
- xmlSchemaCollectionOwningSchema
- String
Skema relasional pemilik tempat kumpulan skema untuk instans XML ini berada.
- xmlSchemaCollectionName
- String
Nama koleksi skema untuk parameter ini.
Keterangan
Size dan Precision disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter dan precision .