SqlParameter Konstruktor

Referensi

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

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.

Menginisialisasi instans baru kelas SqlParameter.

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.

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

Lihat juga

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.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

ArgumentException

Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

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

Keterangan

Jenis data dan, jika sesuai, Ukuran dan Precision disimpulkan dari nilai dbType parameter.

Lihat juga

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 System.Data.SqlClient.SqlParameter : string * obj -> System.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.

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

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.

Lihat juga

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

Parameter

parameterName: String

Nama parameter yang akan dipetakan.

dbType: SqlDbType

Salah SqlDbType satu nilai.

size: Int32

Panjang parameter.

Pengecualian

ArgumentException

Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

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

Keterangan

Ukuran disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter .

Lihat juga

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

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.

Pengecualian

ArgumentException

Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

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

Keterangan

Ukuran disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter .

Lihat juga

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

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.

sourceVersion: DataRowVersion

Salah DataRowVersion satu nilai.

value: Object

Yang Object merupakan nilai dari SqlParameter.

Pengecualian

ArgumentException

Nilai yang disediakan dalam dbType parameter adalah jenis data back-end yang tidak valid.

Contoh

Contoh berikut membuat SqlParameter dan mengatur beberapa propertinya.

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

Keterangan

Ukuran dan Precision disimpulkan dari nilai dbType parameter jika tidak diatur secara eksplisit dalam size parameter dan precision .

Lihat juga

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

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.

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 .

Lihat juga

Berlaku untuk

Bagikan melalui

SqlParameter Konstruktor

Definisi

Overload

SqlParameter()

Contoh

Lihat juga

Berlaku untuk

SqlParameter(String, SqlDbType)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

SqlParameter(String, Object)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

SqlParameter(String, SqlDbType, Int32)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

SqlParameter(String, SqlDbType, Int32, String)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: