SqlParameterCollection.Add Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

Add(SqlParameter)	Dodaje określony SqlParameter obiekt do obiektu SqlParameterCollection.
Add(Object)	Dodaje określony SqlParameter obiekt do obiektu SqlParameterCollection.
Add(String, SqlDbType)	Dodaje element SqlParameter do podanej SqlParameterCollection nazwy parametru i typu danych.
Add(String, SqlDbType, Int32)	SqlParameter Dodaje element do SqlParameterCollectionelementu , przy użyciu określonej nazwy SqlDbType parametru i rozmiaru.
Add(String, SqlDbType, Int32, String)	SqlParameter Dodaje element do elementu SqlParameterCollection z nazwą parametru, typem danych i długością kolumny.

Add(SqlParameter)

Dodaje określony SqlParameter obiekt do obiektu 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

Element SqlParameter do dodania do kolekcji.

Zwraca

SqlParameter

Nowy SqlParameter obiekt.

Wyjątki

ArgumentException

Określony SqlParameter w parametrze value jest już dodany do tego lub innego SqlParameterCollection.

InvalidCastException

Przekazany parametr nie był parametrem SqlParameter.

ArgumentNullException

Parametr value ma wartość null.

Przykłady

using Microsoft.Data.SqlClient;

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

Add(Object)

Dodaje określony SqlParameter obiekt do obiektu 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.

Zwraca

Int32

Indeks nowego SqlParameter obiektu.

Add(String, SqlDbType)

Dodaje element SqlParameter do podanej SqlParameterCollection nazwy parametru i typu danych.

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

Nazwa parametru.

sqlDbType

SqlDbType

SqlDbType Jedna z wartości.

Zwraca

SqlParameter

Nowy SqlParameter obiekt.

Przykłady

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

Add(String, SqlDbType, Int32)

SqlParameter Dodaje element do SqlParameterCollectionelementu , przy użyciu określonej nazwy SqlDbType parametru i rozmiaru.

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

Nazwa parametru.

sqlDbType

SqlDbType

Element SqlDbType do SqlParameter dodania do kolekcji.

size

Int32

Rozmiar jako .Int32

Zwraca

SqlParameter

Nowy SqlParameter obiekt.

Przykłady

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

Uwagi

To przeciążenie jest przydatne podczas dodawania parametru typu danych o zmiennej długości, takiego jak varchar lub binary.

Add(String, SqlDbType, Int32, String)

SqlParameter Dodaje element do elementu SqlParameterCollection z nazwą parametru, typem danych i długością kolumny.

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

Nazwa parametru.

sqlDbType

SqlDbType

SqlDbType Jedna z wartości.

size

Int32

Długość kolumny.

sourceColumn

String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update(DataSet).

Zwraca

SqlParameter

Nowy SqlParameter obiekt.

Przykłady

using Microsoft.Data.SqlClient;

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