SqlParameter Konstruktoren
Definition
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
| 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()
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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType)Parameter
- parameterName
- String
Der Name des zuzuordnenden 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);
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.SqlParameterPublic 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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer)Parameter
- parameterName
- String
Der Name des zuzuordnenden Parameters.
- 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.SqlParameterPublic Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)Parameter
- parameterName
- String
Der Name des zuzuordnenden Parameters.
- 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.SqlParameterPublic 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.
- 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.
- 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.SqlParameterPublic 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.
- 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.
- 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.