Condividi tramite


SqlParameterCollection.Add Metodo

Definizione

Overload

Add(SqlParameter)

Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.

Add(Object)

Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.

Add(String, SqlDbType)

Aggiunge un oggetto SqlParameter a SqlParameterCollection quando vengono specificati il nome di parametro e il tipo di dati.

Add(String, Object)
Obsoleti.

Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.

Add(String, SqlDbType, Int32)

Aggiunge un oggetto SqlParameter all'insieme SqlParameterCollection, dati il nome del parametro specificato e la classe SqlDbType e le dimensioni.

Add(String, SqlDbType, Int32, String)

Aggiunge un oggetto SqlParameter a SqlParameterCollection con il nome di parametro, il tipo di dati e la lunghezza di colonna.

Add(SqlParameter)

Aggiunge l'oggetto SqlParameter specificato all'oggetto 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

Parametri

value
SqlParameter

Oggetto SqlParameter da aggiungere alla raccolta.

Restituisce

Nuovo oggetto SqlParameter.

Eccezioni

L'oggetto SqlParameter specificato nel parametrovalue è già stato aggiunto a questo o a un altro oggetto SqlParameterCollection.

Il parametro passato non è un oggetto SqlParameter.

Il parametro value è null.

Esempio

using Microsoft.Data.SqlClient;

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

Si applica a

Add(Object)

Aggiunge l'oggetto SqlParameter specificato all'oggetto 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

Parametri

value
Object

Oggetto Object.

Restituisce

Indice del nuovo oggetto SqlParameter.

Si applica a

Add(String, SqlDbType)

Aggiunge un oggetto SqlParameter a SqlParameterCollection quando vengono specificati il nome di parametro e il tipo di dati.

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

Parametri

parameterName
String

Nome del parametro.

sqlDbType
SqlDbType

Uno dei valori di SqlDbType.

Restituisce

Nuovo oggetto SqlParameter.

Esempio

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

Si applica a

Add(String, Object)

Attenzione

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

Aggiunge l'oggetto SqlParameter specificato all'oggetto 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

Parametri

parameterName
String

Nome dell'oggetto SqlParameter da aggiungere all'insieme.

value
Object

Oggetto Object.

Restituisce

Nuovo oggetto SqlParameter.

Prestare attenzione quando si utilizza l'overload del metodo SqlParameterCollection.Add per specificare valori di parametro di tipo Integer. Poiché l'overload accetta un value di tipo Object, è necessario convertire il valore integrale in un tipo Object, come illustrato nell'esempio C# riportato di seguito.

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

Se non si esegue questa conversione, il compilatore si comporterà come se si tentasse di chiamare l'overload SqlParameterCollection.Add (string, SqlDbType).

Attributi

Eccezioni

L'oggetto SqlParameter specificato nel parametrovalue è già stato aggiunto a questo o a un altro oggetto SqlParameterCollection.

Il parametro value è null.

Esempio

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

Si applica a

Add(String, SqlDbType, Int32)

Aggiunge un oggetto SqlParameter all'insieme SqlParameterCollection, dati il nome del parametro specificato e la classe SqlDbType e le dimensioni.

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

Parametri

parameterName
String

Nome del parametro.

sqlDbType
SqlDbType

Oggetto SqlDbType di SqlParameter da aggiungere alla raccolta.

size
Int32

Dimensione come oggetto Int32.

Restituisce

Nuovo oggetto SqlParameter.

Esempio

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

Commenti

Questo overload è utile quando si aggiunge un parametro di un tipo di dati a lunghezza variabile, varchar ad esempio o binary.

Si applica a

Add(String, SqlDbType, Int32, String)

Aggiunge un oggetto SqlParameter a SqlParameterCollection con il nome di parametro, il tipo di dati e la lunghezza di colonna.

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

Parametri

parameterName
String

Nome del parametro.

sqlDbType
SqlDbType

Uno dei valori di SqlDbType.

size
Int32

Lunghezza di colonna.

sourceColumn
String

Nome della colonna di origine (SourceColumn) se questo oggetto SqlParameter viene usato in una chiamata a Update(DataSet).

Restituisce

Nuovo oggetto SqlParameter.

Esempio

using Microsoft.Data.SqlClient;

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

Si applica a