Bagikan melalui


SqlParameter Konstruktor

Definisi

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, 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.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)

Parameter

parameterName
String

Nama parameter yang akan dipetakan.

dbType
SqlDbType

Salah SqlDbType satu nilai.

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.SqlParameter
Public 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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parameter

parameterName
String

Nama parameter yang akan dipetakan.

dbType
SqlDbType

Salah SqlDbType satu nilai.

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.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

Parameter

parameterName
String

Nama parameter yang akan dipetakan.

dbType
SqlDbType

Salah SqlDbType satu nilai.

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.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)

Parameter

parameterName
String

Nama parameter yang akan dipetakan.

dbType
SqlDbType

Salah SqlDbType satu nilai.

size
Int32

Panjang parameter.

direction
ParameterDirection

Salah ParameterDirection satu nilai.

isNullable
Boolean

true jika nilai bidang bisa null; jika tidak, false.

precision
Byte

Jumlah total digit di sebelah kiri dan kanan titik desimal yang Value diselesaikan.

scale
Byte

Jumlah total tempat desimal yang Value diselesaikan.

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.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)

Parameter

parameterName
String

Nama parameter yang akan dipetakan.

dbType
SqlDbType

Salah SqlDbType satu nilai.

size
Int32

Panjang parameter.

direction
ParameterDirection

Salah ParameterDirection satu nilai.

precision
Byte

Jumlah total digit di sebelah kiri dan kanan titik desimal yang Value diselesaikan.

scale
Byte

Jumlah total tempat desimal yang Value diselesaikan.

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 .

Berlaku untuk