SqlParameter Konstruktoren

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

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.

Initialisiert eine neue Instanz der SqlParameter-Klasse.

Überlädt

SqlParameter()	Initialisiert eine neue Instanz der SqlParameter-Klasse.
SqlParameter(String, SqlDbType)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und den Datentyp verwendet.
SqlParameter(String, Object)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und einen Wert des neuen SqlParameter verwendet.
SqlParameter(String, SqlDbType, Int32)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType und die Größe verwendet.
SqlParameter(String, SqlDbType, Int32, String)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType, die Größe und den Quellspaltennamen verwendet.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den Typ des Parameters, die Größe des Parameters, ein ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, ein zu verwendendes DataRowVersion und den Wert des Parameters verwendet.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initialisiert eine neue Instanz der SqlParameter-Klasse, die Folgendes verwendet: den Parameternamen, den Parametertyp, die Parameterlänge, die Richtung, die Genauigkeit, die Skala, den Namen der Quellspalte, einen der DataRowVersion-Werte, einen booleschen Wert für die Quellspaltenzuordnung, den Wert von `SqlParameter`, den Namen der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet, das besitzende relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet, und den Namen der Schemaauflistung für diesen Parameter.

SqlParameter()

Initialisiert eine neue Instanz der SqlParameter-Klasse.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter();
    parameter.ParameterName = "@Description";
    parameter.IsNullable = true;
    parameter.SqlDbType = SqlDbType.VarChar;
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = 88;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und den Datentyp verwendet.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

dbType: SqlDbType

Einer der SqlDbType-Werte.

Ausnahmen

ArgumentException

Der im dbType-Parameter angegebene Wert ist ein ungültiger Back-End-Datentyp.

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command, string paramValue)
{
    SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = 88;
    parameter.Value = paramValue;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Hinweise

Der Datentyp und ggf. Die Größe und Precision werden aus dem Wert des dbType Parameters abgeleitet.

Weitere Informationen

Gilt für:

SqlParameter(String, Object)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und einen Wert des neuen SqlParameter verwendet.

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter (string parameterName, object value);

new System.Data.SqlClient.SqlParameter : string * obj -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

value: Object

Ein Object, das den Wert des SqlParameter darstellt.

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88, "Description");
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Hinweise

Wenn Sie einen Object im value -Parameter angeben, wird der SqlDbType vom Microsoft-.NET Framework -Typ abgeleitetObject.

Gehen Sie vorsichtig vor, wenn Sie diese Überladung des SqlParameter Konstruktors verwenden, um ganzzahlige Parameterwerte anzugeben. 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.

Parameter = new SqlParameter("@pname", (object)0);

Wenn Sie diese Konvertierung nicht durchführen, geht der Compiler davon aus, dass Sie versuchen, die SqlParameter(String, SqlDbType) Konstruktorüberladung aufzurufen.

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType und die Größe verwendet.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

dbType: SqlDbType

Einer der SqlDbType-Werte.

size: Int32

Die Länge des Parameters.

Ausnahmen

ArgumentException

Der im dbType-Parameter angegebene Wert ist ein ungültiger Back-End-Datentyp.

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command,
    string paramValue)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88);
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;
    parameter.Value = paramValue;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Hinweise

Die Größe wird aus dem Wert des dbType Parameters abgeleitet, wenn er nicht explizit im size Parameter festgelegt ist.

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, String)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType, die Größe und den Quellspaltennamen verwendet.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

dbType: SqlDbType

Einer der SqlDbType-Werte.

size: Int32

Die Länge des Parameters.

sourceColumn: String

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

Ausnahmen

ArgumentException

Der im dbType-Parameter angegebene Wert ist ein ungültiger Back-End-Datentyp.

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88, "Description");
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Hinweise

Die Größe wird aus dem Wert des dbType Parameters abgeleitet, wenn er nicht explizit im size Parameter festgelegt ist.

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den Typ des Parameters, die Größe des Parameters, ein ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, ein zu verwendendes DataRowVersion und den Wert des Parameters verwendet.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

dbType: SqlDbType

Einer der SqlDbType-Werte.

size: Int32

Die Länge des Parameters.

direction: ParameterDirection

Einer der ParameterDirection-Werte.

isNullable: Boolean

true, wenn der Wert des Felds NULL sein kann, andernfalls false.

precision: Byte

Die Gesamtanzahl der Ziffern links und rechts vom Dezimaltrennzeichen, in die Value aufgelöst wird.

scale: Byte

Die Gesamtanzahl der Dezimalstellen, in die Value aufgelöst wird.

sourceColumn: String

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

sourceVersion: DataRowVersion

Einer der DataRowVersion-Werte.

value: Object

Ein Object, das den Wert des SqlParameter darstellt.

Ausnahmen

ArgumentException

Der im dbType-Parameter angegebene Wert ist ein ungültiger Back-End-Datentyp.

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 11, ParameterDirection.Input,
        true, 0, 0, "Description", DataRowVersion.Current,
        "garden hose");
    parameter.IsNullable = true;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

Hinweise

Die Größe und Precision werden aus dem Wert des dbType Parameters abgeleitet, wenn sie nicht explizit in den size Parametern und precision festgelegt sind.

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Initialisiert eine neue Instanz der SqlParameter-Klasse, die Folgendes verwendet: den Parameternamen, den Parametertyp, die Parameterlänge, die Richtung, die Genauigkeit, die Skala, den Namen der Quellspalte, einen der DataRowVersion-Werte, einen booleschen Wert für die Quellspaltenzuordnung, den Wert von SqlParameter, den Namen der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet, das besitzende relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet, und den Namen der Schemaauflistung für diesen Parameter.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)

Parameter

parameterName: String

Der Name des zuzuordnenden Parameters.

dbType: SqlDbType

Einer der SqlDbType-Werte.

size: Int32

Die Länge des Parameters.

direction: ParameterDirection

Einer der ParameterDirection-Werte.

precision: Byte

Die Gesamtanzahl der Ziffern links und rechts vom Dezimaltrennzeichen, in die Value aufgelöst wird.

scale: Byte

Die Gesamtanzahl der Dezimalstellen, in die Value aufgelöst wird.

sourceColumn: String

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

sourceVersion: DataRowVersion

Einer der DataRowVersion-Werte.

sourceColumnNullMapping: Boolean

true, wenn die Quellspalte NULL-Werte zulässt, andernfalls false.

value: Object

Ein Object, das den Wert des SqlParameter darstellt.

xmlSchemaCollectionDatabase: String

Der Name der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet.

xmlSchemaCollectionOwningSchema: String

Das besitzende relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet.

xmlSchemaCollectionName: String

Der Name der Schemaauflistung für diesen Parameter.

Hinweise

Die Size und Precision werden aus dem Wert des dbType Parameters abgeleitet, wenn sie nicht explizit in den size Parametern und precision festgelegt sind.

Weitere Informationen

Gilt für:

Freigeben über

SqlParameter Konstruktoren

Definition

Überlädt

SqlParameter()

Beispiele

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlParameter(String, Object)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen