SqlParameterCollection.Add Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.SqlParameterPublic Function Add (value As SqlParameter) As SqlParameterParametri
- 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 -> intPublic Overrides Function Add (value As Object) As IntegerParametri
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameterParametri
- parameterName
- String
Nome del parametro.
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.SqlParameterPublic Function Add (parameterName As String, value As Object) As SqlParameterParametri
- parameterName
- String
Nome dell'oggetto SqlParameter da aggiungere all'insieme.
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameterParametri
- parameterName
- String
Nome del parametro.
- sqlDbType
- SqlDbType
Oggetto SqlDbType di SqlParameter da aggiungere alla raccolta.
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameterParametri
- parameterName
- String
Nome del parametro.
- 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");
}
}