Sdílet prostřednictvím


SqlParameterCollection.Add Metoda

Definice

Přetížení

Add(SqlParameter)

Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.

Add(Object)

Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.

Add(String, SqlDbType)

Přidá parametr SqlParameter k zadanému SqlParameterCollection názvu parametru a datovému typu.

Add(String, Object)
Zastaralé.

Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.

Add(String, SqlDbType, Int32)

Přidá do parametru SqlParameterSqlParameterCollection, a to s ohledem na zadaný název SqlDbType parametru a velikost.

Add(String, SqlDbType, Int32, String)

Přidá do SqlParameter parametru SqlParameterCollection s názvem parametru, datovým typem a délkou sloupce.

Add(SqlParameter)

Přidá zadaný SqlParameter objekt do objektu 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

Parametry

value
SqlParameter

Chcete-li SqlParameter přidat do kolekce.

Návraty

Nový SqlParameter objekt.

Výjimky

Zadaný SqlParameter parametr value je již přidán do tohoto nebo jiného parametru SqlParameterCollection.

Předaný parametr nebyl SqlParameter.

Parametr value má hodnotu null.

Příklady

using Microsoft.Data.SqlClient;

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

Platí pro

Add(Object)

Přidá zadaný SqlParameter objekt do objektu 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

Parametry

value
Object

An Object.

Návraty

Index nového SqlParameter objektu.

Platí pro

Add(String, SqlDbType)

Přidá parametr SqlParameter k zadanému SqlParameterCollection názvu parametru a datovému typu.

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

Parametry

parameterName
String

Název parametru

sqlDbType
SqlDbType

Jedna z SqlDbType hodnot.

Návraty

Nový SqlParameter objekt.

Příklady

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";
    }
}

Platí pro

Add(String, Object)

Upozornění

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

Přidá zadaný SqlParameter objekt do objektu 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

Parametry

parameterName
String

Název objektu, který SqlParameter chcete přidat do kolekce.

value
Object

Úloha Object.

Návraty

Nový SqlParameter objekt.

Při použití tohoto přetížení metody k zadání hodnot celočíselných SqlParameterCollection.Add parametrů buďte opatrní. Vzhledem k tomu, že toto přetížení přebírá value typ Object, musíte převést celočíselnou hodnotu na Object typ, pokud je hodnota nula, jak ukazuje následující příklad jazyka C#.

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

Pokud tento převod neprovedete, kompilátor předpokládá, že se pokoušíte volat SqlParameterCollection.Add přetížení (string, SqlDbType).

Atributy

Výjimky

Zadaný SqlParameter parametr value je již přidán do tohoto nebo jiného parametru SqlParameterCollection.

Parametr value má hodnotu null.

Příklady

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

Platí pro

Add(String, SqlDbType, Int32)

Přidá do parametru SqlParameterSqlParameterCollection, a to s ohledem na zadaný název SqlDbType parametru a velikost.

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

Parametry

parameterName
String

Název parametru

sqlDbType
SqlDbType

The SqlDbType of the SqlParameter add to the collection.

size
Int32

Velikost jako Int32.

Návraty

Nový SqlParameter objekt.

Příklady

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

Poznámky

Toto přetížení je užitečné, když přidáváte parametr datového typu s proměnnou délkou, například varchar nebo binary.

Platí pro

Add(String, SqlDbType, Int32, String)

Přidá do SqlParameter parametru SqlParameterCollection s názvem parametru, datovým typem a délkou sloupce.

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

Parametry

parameterName
String

Název parametru

sqlDbType
SqlDbType

Jedna z SqlDbType hodnot.

size
Int32

Délka sloupce.

sourceColumn
String

Název zdrojového sloupce (SourceColumn), pokud SqlParameter se používá při volání Update(DataSet).

Návraty

Nový SqlParameter objekt.

Příklady

using Microsoft.Data.SqlClient;

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

Platí pro