SqlParameter Konstruktoren

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

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

Name	Beschreibung
SqlParameter()	Initialisiert eine neue Instanz der SqlParameter-Klasse.
SqlParameter(String, SqlDbType)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen und den Datentyp verwendet.
SqlParameter(String, Object)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen und einen Wert des neuen SqlParameterverwendet.
SqlParameter(String, SqlDbType, Int32)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröße und die Größe verwendet.
SqlParameter(String, SqlDbType, Int32, String)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröß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, a ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, die DataRowVersion zu verwendende Spalte 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 den Parameternamen, den Typ des Parameters, die Länge des Parameters, die Richtung, die Genauigkeit, die Skalierung, den Namen der Quellspalte, einen der Werte, einen booleschen DataRowVersion Wert für die Quellspaltenzuordnung, den Wert des `SqlParameter`Parameters, den Namen der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet, das eigene relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet, und den Namen der Schemaauflistung für diesen Parameter.

SqlParameter()

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlParameter-Klasse.

public:
 SqlParameter();

public SqlParameter();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein SqlParameter Teil seiner Eigenschaften erstellt und 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)

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der Klasse, die SqlParameter 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 Teil seiner Eigenschaften erstellt und 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 gegebenenfalls "Size " und Precision werden vom Wert des dbType Parameters abgeleitet.

Weitere Informationen

Gilt für:

SqlParameter(String, Object)

Quelle:: System.Data.SqlClient.notsupported.cs

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

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

Dies Object ist der Wert der SqlParameter.

Beispiele

Im folgenden Beispiel wird ein SqlParameter Teil seiner Eigenschaften erstellt und 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 Parameter value angeben, wird der SqlDbType vom Microsoft .NET Typ des Object abgeleitet.

Gehen Sie vorsichtig vor, wenn Sie diese Überladung des SqlParameter Konstruktors verwenden, um ganzzahlige Parameterwerte anzugeben. Da diese Überladung einen value Typ Objectverwendet, müssen Sie den integralen Wert in einen Object Typ konvertieren, wenn der Wert null ist, wie im folgenden C#-Beispiel veranschaulicht.

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

Wenn Sie diese Konvertierung nicht ausfü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)

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröße 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 Teil seiner Eigenschaften erstellt und 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

The Size isferred from the value of the dbType parameter if it is not explicitly set in the size parameter.

Weitere Informationen

Gilt für:

SqlParameter(String, SqlDbType, Int32, String)

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröß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 dies SqlParameter in einem Aufruf von Update.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Beispiel wird ein SqlParameter Teil seiner Eigenschaften erstellt und 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

The Size isferred from the value of the dbType parameter if it is not explicitly set in the size parameter.

Weitere Informationen

Gilt für:

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

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlParameter Klasse, die den Parameternamen, den Typ des Parameters, die Größe des Parameters, a ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, die DataRowVersion zu verwendende Spalte 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

truewenn der Wert des Felds null sein kann; andernfalls . false

precision: Byte

Die Gesamtzahl der Ziffern links und rechts vom Dezimalkomma, zu dem Value aufgelöst wird.

scale: Byte

Die Gesamtzahl der Dezimalstellen, an die Value aufgelöst wird.

sourceColumn: String

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

sourceVersion: DataRowVersion

Einer der DataRowVersion Werte.

value: Object

Dies Object ist der Wert der SqlParameter.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Beispiel wird ein SqlParameter Teil seiner Eigenschaften erstellt und 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 vom Wert des dbType Parameters abgeleitet, wenn sie nicht explizit in den size Parametern und precision Parametern festgelegt werden.

Weitere Informationen

Gilt für:

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

Quelle:: System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlParameter Klasse, die den Parameternamen, den Typ des Parameters, die Länge des Parameters, die Richtung, die Genauigkeit, die Skalierung, den Namen der Quellspalte, einen der Werte, einen booleschen DataRowVersion Wert für die Quellspaltenzuordnung, den Wert des SqlParameterParameters, den Namen der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet, das eigene 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 Gesamtzahl der Ziffern links und rechts vom Dezimalkomma, zu dem Value aufgelöst wird.

scale: Byte

Die Gesamtzahl der Dezimalstellen, an die Value aufgelöst wird.

sourceColumn: String

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

sourceVersion: DataRowVersion

Einer der DataRowVersion Werte.

sourceColumnNullMapping: Boolean

true wenn die Quellspalte nullwertebar ist; false wenn nicht.

value: Object

Dies Object ist der Wert der SqlParameter.

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

Das eigene 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 vom Wert des dbType Parameters abgeleitet, wenn sie nicht explizit in den size parametern festgelegt precision sind.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?