Freigeben über


SqlParameter Konstruktoren

Definition

Ü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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.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

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Hinweise

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

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 Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Hinweise

Wenn Sie einen Object im value -Parameter angeben, wird aus SqlDbType dem Microsoft-.NET Framework Typ von Objectabgeleitet.

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.

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.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

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Hinweise

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.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(DataSet)>verwendet wird.

Ausnahmen

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Hinweise

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.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(DataSet) verwendet wird.

sourceVersion
DataRowVersion

Einer der DataRowVersion-Werte.

value
Object

Ein Object, das den Wert des SqlParameter darstellt.

Ausnahmen

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Hinweise

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.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(DataSet)>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

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

Gilt für: