SqlParameterCollection.Add Methode

Referenz

Definition

Namespace:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Add(SqlParameter)	Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.
Add(Object)	Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.
Add(String, SqlDbType)	Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.
Add(String, Object)	Veraltet. Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.
Add(String, SqlDbType, Int32)	Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.
Add(String, SqlDbType, Int32, String)	Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.

Add(SqlParameter)

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.

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

Parameter

value: SqlParameter

Der der Auflistung hinzuzufügende SqlParameter.

Gibt zurück

SqlParameter

Ein neues SqlParameter-Objekt.

Ausnahmen

ArgumentException

Der im value-Parameter angegebene SqlParameter wurde bereits dieser oder einer anderen SqlParameterCollection hinzugefügt.

InvalidCastException

Der übergebene Parameter war kein SqlParameter.

ArgumentNullException

Der value-Parameter ist null.

Beispiele

using Microsoft.Data.SqlClient;

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

Gilt für:

Add(Object)

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.

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

Parameter

value: Object

Object.

Gibt zurück

Int32

Der Index des neuen SqlParameter-Objekts.

Gilt für:

Add(String, SqlDbType)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.

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

Parameter

parameterName: String

Der Name des Parameters.

sqlDbType: SqlDbType

Einer der SqlDbType-Werte.

Gibt zurück

SqlParameter

Ein neues SqlParameter-Objekt.

Beispiele

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

Gilt für:

Add(String, Object)

Achtung

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

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.

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

Parameter

parameterName: String

Der Name des SqlParameter, der der Auflistung hinzugefügt werden soll.

value: Object

Ein Object.

Gibt zurück

SqlParameter

Ein neues SqlParameter-Objekt.

Gehen Sie mit Bedacht vor, wenn Sie mit dieser Überladung der SqlParameterCollection.Add-Methode ganzzahlige Parameterwerte festlegen. 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.

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.

Attribute: ObsoleteAttribute

Ausnahmen

ArgumentException

Der im value-Parameter angegebene SqlParameter wurde bereits dieser oder einer anderen SqlParameterCollection hinzugefügt.

ArgumentNullException

Der value-Parameter ist null.

Beispiele

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

Gilt für:

Add(String, SqlDbType, Int32)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.

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

Parameter

parameterName: String

Der Name des Parameters.

sqlDbType: SqlDbType

Der SqlDbType von SqlParameter, der der Auflistung hinzugefügt werden soll.

size: Int32

Die Größe als Int32.

Gibt zurück

SqlParameter

Ein neues SqlParameter-Objekt.

Beispiele

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

Hinweise

Diese Überladung ist nützlich, wenn Sie einen Parameter eines Datentyps mit variabler Länge hinzufügen, z varchar . B. oder binary.

Gilt für:

Add(String, SqlDbType, Int32, String)

Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.

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

Parameter

parameterName: String

Der Name des Parameters.

sqlDbType: SqlDbType

Einer der SqlDbType-Werte.

size: Int32

Die Spaltenlänge.

sourceColumn: String

Der Name der Quellspalte (SourceColumn), wenn dieser SqlParameter in einem Aufruf von Update(DataSet) verwendet wird.

Gibt zurück

SqlParameter

Ein neues SqlParameter-Objekt.

Beispiele

using Microsoft.Data.SqlClient;

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

Gilt für:

Freigeben über

SqlParameterCollection.Add Methode

Definition

Überlädt

Add(SqlParameter)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für:

Add(Object)

Parameter

Gibt zurück

Gilt für:

Add(String, SqlDbType)

Parameter

Gibt zurück

Beispiele

Gilt für:

Add(String, Object)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für:

Add(String, SqlDbType, Int32)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

Add(String, SqlDbType, Int32, String)

Parameter

Gibt zurück

Beispiele

Gilt für:

Zusätzliche Ressourcen