Bagikan melalui


SqlParameterCollection.Add Metode

Definisi

Overload

Add(SqlParameter)

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

Add(Object)

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

Add(String, SqlDbType)

SqlParameter Menambahkan ke SqlParameterCollection nama parameter dan jenis data yang diberikan.

Add(String, Object)
Kedaluwarsa.

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

Add(String, SqlDbType, Int32)

SqlParameter Menambahkan ke SqlParameterCollection, dengan nama SqlDbType parameter dan ukuran yang ditentukan.

Add(String, SqlDbType, Int32, String)

SqlParameter Menambahkan ke SqlParameterCollection dengan nama parameter, jenis data, dan panjang kolom.

Add(SqlParameter)

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(Microsoft::Data::SqlClient::SqlParameter ^ value);
public Microsoft.Data.SqlClient.SqlParameter Add (Microsoft.Data.SqlClient.SqlParameter value);
override this.Add : Microsoft.Data.SqlClient.SqlParameter -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (value As SqlParameter) As SqlParameter

Parameter

value
SqlParameter

untuk SqlParameter ditambahkan ke koleksi.

Mengembalikan

Objek baru SqlParameter .

Pengecualian

Yang SqlParameter ditentukan dalam value parameter sudah ditambahkan ke ini atau yang lain SqlParameterCollection.

Parameter yang diteruskan bukan .SqlParameter

Parameternya value null.

Contoh

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        command.Parameters.Add(new SqlParameter("Description", "Beverages"));
    }
}

Berlaku untuk

Add(Object)

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

public:
 override int Add(System::Object ^ value);
public override int Add (object value);
override this.Add : obj -> int
Public Overrides Function Add (value As Object) As Integer

Parameter

value
Object

Sebuah Object.

Mengembalikan

Indeks objek baru SqlParameter .

Berlaku untuk

Add(String, SqlDbType)

SqlParameter Menambahkan ke SqlParameterCollection nama parameter dan jenis data yang diberikan.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);
override this.Add : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameter

Parameter

parameterName
String

Nama parameter.

sqlDbType
SqlDbType

Salah SqlDbType satu nilai.

Mengembalikan

Objek baru SqlParameter .

Contoh

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = command.Parameters.Add(
            "@Description", SqlDbType.NVarChar);
        param.Size = 16;
        param.Value = "Beverages";
    }
}

Berlaku untuk

Add(String, Object)

Perhatian

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202

Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, object value);
[<System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, value As Object) As SqlParameter

Parameter

parameterName
String

Nama untuk SqlParameter ditambahkan ke koleksi.

value
Object

Object.

Mengembalikan

Objek baru SqlParameter .

Berhati-hatilah saat Anda menggunakan kelebihan beban metode ini untuk menentukan nilai parameter bilangan SqlParameterCollection.Add 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.

parameters.Add("@pname", Convert.ToInt32(0));  

Jika Anda tidak melakukan konversi ini, pengkompilasi mengasumsikan bahwa Anda mencoba memanggil SqlParameterCollection.Add kelebihan beban (string, SqlDbType) .

Atribut

Pengecualian

Yang SqlParameter ditentukan dalam value parameter sudah ditambahkan ke ini atau yang lain SqlParameterCollection.

Parameternya value null.

Contoh

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

Berlaku untuk

Add(String, SqlDbType, Int32)

SqlParameter Menambahkan ke SqlParameterCollection, dengan nama SqlDbType parameter dan ukuran yang ditentukan.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);
override this.Add : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameter

Parameter

parameterName
String

Nama parameter.

sqlDbType
SqlDbType

SqlDbType dari SqlParameter untuk ditambahkan ke koleksi.

size
Int32

Ukuran sebagai Int32.

Mengembalikan

Objek baru SqlParameter .

Contoh

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

Keterangan

Kelebihan beban ini berguna saat Anda menambahkan parameter jenis data dengan panjang variabel seperti varchar atau binary.

Berlaku untuk

Add(String, SqlDbType, Int32, String)

SqlParameter Menambahkan ke SqlParameterCollection dengan nama parameter, jenis data, dan panjang kolom.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);
override this.Add : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameter

Parameter

parameterName
String

Nama parameter.

sqlDbType
SqlDbType

Salah SqlDbType satu nilai.

size
Int32

Panjang kolom.

sourceColumn
String

Nama kolom sumber (SourceColumn) jika ini SqlParameter digunakan dalam panggilan ke Update(DataSet).

Mengembalikan

Objek baru SqlParameter .

Contoh

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand cmd)
    {
        SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
    }
}

Berlaku untuk