SqlParameterCollection.Add Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
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.
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.
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
- 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");
}
}