SqlParameter Konstruktorok
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Inicializálja a SqlParameter osztály új példányát.
Túlterhelések
| Name | Description |
|---|---|
| SqlParameter() |
Inicializálja a SqlParameter osztály új példányát. |
| SqlParameter(String, SqlDbType) |
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az adattípust használja. |
| SqlParameter(String, Object) |
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az új SqlParameterértéket használja. |
| SqlParameter(String, SqlDbType, Int32) |
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a méretet és a SqlDbTypeparaméter nevét használja. |
| SqlParameter(String, SqlDbType, Int32, String) |
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a SqlDbTypeméretet és a forrásoszlop nevét használja. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, típusát, a paraméter méretét, ParameterDirectiona paraméter pontosságát, a paraméter skáláját, a forrásoszlopot DataRowVersion , a használandó értéket és a paraméter értékét használja. |
| SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Inicializálja annak az osztálynak az SqlParameter új példányát, amely a paraméter nevét, a paraméter típusát, az irányt, a pontosságot, a skálát, a forrásoszlop nevét, az értékek egyikét DataRowVersion , a forrásoszlop-leképezés logikai értékét, a |
SqlParameter()
Inicializálja a SqlParameter osztály új példányát.
public:
SqlParameter();
public SqlParameter();
Public Sub New ()
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Lásd még
A következőre érvényes:
SqlParameter(String, SqlDbType)
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az adattípust használja.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
Kivételek
A paraméterben dbType megadott érték érvénytelen háttéradat-típus.
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Megjegyzések
Az adattípus és adott esetben a Méret , és Precision a paraméter értékéből következtetnek dbType .
Lásd még
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése
A következőre érvényes:
SqlParameter(String, Object)
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az új SqlParameterértéket használja.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
- value
- Object
Ez Object az érték a SqlParameter.
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Megjegyzések
Ha a Object paraméterben value ad meg, a SqlDbType a Object Microsoft .NET típusából lesz kikövetkeztetve.
Ügyeljen arra, hogy a konstruktor túlterhelésével adja meg az SqlParameter egész szám paraméterértékét. Mivel ez a túlterhelés egy típust valuevesz igénybeObject, az integrálértéket olyan típussá kell konvertálniaObject, amely nulla, ahogyan azt az alábbi C# példa szemlélteti.
Parameter = new SqlParameter("@pname", (object)0);
Ha nem hajtja végre ezt az átalakítást, a fordító feltételezi, hogy a konstruktor túlterhelését SqlParameter(String, SqlDbType) próbálja meghívni.
Lásd még
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése
A következőre érvényes:
SqlParameter(String, SqlDbType, Int32)
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a méretet és a SqlDbTypeparaméter nevét használja.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
- size
- Int32
A paraméter hossza.
Kivételek
A paraméterben dbType megadott érték érvénytelen háttéradat-típus.
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Megjegyzések
A méret a paraméter értékéből dbType következtet, ha nincs explicit módon beállítva a size paraméterben.
Lásd még
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése
A következőre érvényes:
SqlParameter(String, SqlDbType, Int32, String)
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a SqlDbTypeméretet és a forrásoszlop nevét használja.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
- size
- Int32
A paraméter hossza.
- sourceColumn
- String
A forrásoszlop (SourceColumn) neve, ha ezt SqlParameter használják a hívásban Update.
Kivételek
A paraméterben dbType megadott érték érvénytelen háttéradat-típus.
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Megjegyzések
A méret a paraméter értékéből dbType következtet, ha nincs explicit módon beállítva a size paraméterben.
Lásd még
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése
A következőre érvényes:
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, típusát, a paraméter méretét, ParameterDirectiona paraméter pontosságát, a paraméter skáláját, a forrásoszlopot DataRowVersion , a használandó értéket és a paraméter értékét használja.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
- size
- Int32
A paraméter hossza.
- direction
- ParameterDirection
Az egyik ParameterDirection érték.
- isNullable
- Boolean
trueha a mező értéke null értékű lehet; egyéb esetben. false
- sourceColumn
- String
A forrásoszlop (SourceColumn) neve, ha ezt SqlParameter használják a hívásban Update.
- sourceVersion
- DataRowVersion
Az egyik DataRowVersion érték.
- value
- Object
Ez Object az érték a SqlParameter.
Kivételek
A paraméterben dbType megadott érték érvénytelen háttéradat-típus.
Példák
Az alábbi példa létrehoz egy SqlParameter és beállít néhány tulajdonságot.
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
Megjegyzések
A méret, és Precision a paraméter értékéből dbType következtet, ha nincsenek explicit módon beállítva a paraméterekben és size a precision paraméterekben.
Lásd még
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése
A következőre érvényes:
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Inicializálja annak az osztálynak az SqlParameter új példányát, amely a paraméter nevét, a paraméter típusát, az irányt, a pontosságot, a skálát, a forrásoszlop nevét, az értékek egyikét DataRowVersion , a forrásoszlop-leképezés logikai értékét, a SqlParameterparaméter értékét, annak az adatbázisnak a nevét használja, amelyben az XML-példány sémagyűjteménye található, a tulajdonos relációs sémát, ahol az XML-példány sémagyűjteménye található, és a paraméter sémagyűjteményének neve.
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)
Paraméterek
- parameterName
- String
A megfeleltetendő paraméter neve.
- size
- Int32
A paraméter hossza.
- direction
- ParameterDirection
Az egyik ParameterDirection érték.
- sourceColumn
- String
A forrásoszlop (SourceColumn) neve, ha ezt SqlParameter használják a hívásban Update.
- sourceVersion
- DataRowVersion
Az egyik DataRowVersion érték.
- sourceColumnNullMapping
- Boolean
true ha a forrásoszlop null értékű; false ha nem.
- value
- Object
Ez Object az érték a SqlParameter.
- xmlSchemaCollectionDatabase
- String
Annak az adatbázisnak a neve, amelyben az XML-példány sémagyűjteménye található.
- xmlSchemaCollectionOwningSchema
- String
A tulajdonos relációs séma, ahol az XML-példány sémagyűjteménye található.
- xmlSchemaCollectionName
- String
A paraméter sémagyűjteményének neve.
Megjegyzések
Size A Precision paraméter értékéből dbType következtet, ha nincsenek explicit módon beállítva a paraméterekben és size a precision paraméterekben.
Lásd még
- SQL Server-adattípusok és ADO.NET
- Parancsok és paraméterek (ADO.NET)
- DataAdapter parameters (ADO.NET)
A .NET-keretrendszer Data Provider használata SQL Server - ADO.NET áttekintése