SqlParameterCollection.Add SqlParameterCollection.Add SqlParameterCollection.Add SqlParameterCollection.Add Method

Definition

Überlädt

Add(SqlParameter) Add(SqlParameter) Add(SqlParameter) Add(SqlParameter)

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(Object) Add(Object) Add(Object) Add(Object)

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String)

Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

Add(SqlParameter) Add(SqlParameter) Add(SqlParameter) Add(SqlParameter)

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::Data::SqlClient::SqlParameter ^ value);
public System.Data.SqlClient.SqlParameter Add (System.Data.SqlClient.SqlParameter value);
member this.Add : System.Data.SqlClient.SqlParameter -> System.Data.SqlClient.SqlParameter
Public Function Add (value As SqlParameter) As SqlParameter

Parameter

value
SqlParameter SqlParameter SqlParameter SqlParameter

Der der Auflistung hinzuzufügende SqlParameter.The SqlParameter to add to the collection.

Gibt zurück

Ausnahmen

Der im value-Parameter angegebene SqlParameter wurde bereits dieser oder einer anderen SqlParameterCollection hinzugefügt.The SqlParameter specified in the value parameter is already added to this or another SqlParameterCollection.

Der übergebene Parameter war kein SqlParameter.The parameter passed was not a SqlParameter.

Der value-Parameter ist null.The value parameter is null.

Beispiele

public void AddSqlParameter(SqlCommand command) 
{
    command.Parameters.Add(new SqlParameter("Description", "Beverages"));
}
Public Sub AddSqlParameter(command As SqlCommand) 
  command.Parameters.Add(New SqlParameter("Description", "Beverages"))
End Sub
Siehe auch

Add(Object) Add(Object) Add(Object) Add(Object)

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 virtual int Add(System::Object ^ value);
public int Add (object value);
abstract member Add : obj -> int
override this.Add : obj -> int
Public Function Add (value As Object) As Integer

Parameter

Gibt zurück

Der Index des neuen SqlParameter-Objekts.The index of the new SqlParameter object.

Implementiert

Siehe auch

Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);
member this.Add : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter

Parameter

parameterName
String String String String

Der Name des Parameters.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

Einer der SqlDbType-Werte.One of the SqlDbType values.

Gibt zurück

Beispiele

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = command.Parameters.Add(
        "@Description", SqlDbType.NVarChar);
    param.Size = 16;
    param.Value = "Beverages";
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As SqlParameter = command.Parameters.Add( _
      "@Description", SqlDbType.NVarChar)
  param.Size = 16
  param.Value = "Beverages"
End Sub
Siehe auch

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Warnung

Diese API ist jetzt veraltet.

Fügt der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
[System.Obsolete("Do not call this method.")]
[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 System.Data.SqlClient.SqlParameter Add (string parameterName, object value);
override this.Add : string * obj -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, value As Object) As SqlParameter

Parameter

parameterName
String String String String

Der Name des SqlParameter, der der Auflistung hinzugefügt werden soll.The name of the SqlParameter to add to the collection.

Gibt zurück

Ein neues SqlParameter-Objekt.A new SqlParameter object.

Gehen Sie mit Bedacht vor, wenn Sie mit dieser Überladung der SqlParameterCollection.Add-Methode ganzzahlige Parameterwerte festlegen.Use caution when you are using this overload of the SqlParameterCollection.Add method to specify integer parameter values. Da diese Überladung einen value vom Typ Object akzeptiert, müssen Sie den Ganzzahlwert in einen Object-Typ konvertieren, wenn der der Wert 0 (null) ist. Dies wird im folgenden C#-Beispiel veranschaulicht.Because this overload takes a value of type Object, you must convert the integral value to an Object type when the value is zero, as the following C# example demonstrates.

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

Wenn diese Konvertierung nicht ausgeführt wird, geht der Compiler davon aus, dass die SqlParameterCollection.Add-Überladung (string, SqlDbType) aufgerufen werden soll.If you do not perform this conversion, the compiler assumes that you are trying to call the SqlParameterCollection.Add (string, SqlDbType) overload.

Ausnahmen

Der im value-Parameter angegebene SqlParameter wurde bereits dieser oder einer anderen SqlParameterCollection hinzugefügt.The SqlParameter specified in the value parameter is already added to this or another SqlParameterCollection.

Der value-Parameter ist null.The value parameter is null.

Beispiele

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub
Siehe auch

Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);
member this.Add : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter

Parameter

parameterName
String String String String

Der Name des Parameters.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

Der SqlDbType von SqlParameter, der der Auflistung hinzugefügt werden soll.The SqlDbType of the SqlParameter to add to the collection.

size
Int32 Int32 Int32 Int32

Die Größe als Int32.The size as an Int32.

Gibt zurück

Beispiele

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub

Hinweise

Diese Überladung ist nützlich, wenn Sie einen Parameter eines Datentyps variabler Länge hinzufügen varchar , binaryz. b. oder.This overload is useful when you are adding a parameter of a variable-length data type such as varchar or binary.

Siehe auch

Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String)

Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);
member this.Add : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter

Parameter

parameterName
String String String String

Der Name des Parameters.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

Einer der SqlDbType-Werte.One of the SqlDbType values.

size
Int32 Int32 Int32 Int32

Die Spaltenlänge.The column length.

sourceColumn
String String String String

Der Name der Quellspalte (SourceColumn), wenn dieser SqlParameter in einem Aufruf von Update verwendet wird.The name of the source column (SourceColumn) if this SqlParameter is used in a call to Update.

Gibt zurück

Beispiele

public void AddSqlParameter(SqlCommand cmd) 
{
  SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
}
Public Sub AddSqlParameter(cmd As SqlCommand) 
  Dim p1 As SqlParameter = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description")
End Sub
Siehe auch

Gilt für: