SqlParameter Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci SqlParameter třídy.
Přetížení
SqlParameter() |
Inicializuje novou instanci SqlParameter třídy. |
SqlParameter(String, SqlDbType) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ. |
SqlParameter(String, Object) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nového SqlParameter. |
SqlParameter(String, SqlDbType, Int32) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, a SqlDbTypevelikost. |
SqlParameter(String, SqlDbType, Int32, String) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, SqlDbTypevelikost a název zdrojového sloupce. |
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, velikost parametru, přesnost parametru, ParameterDirectionměřítko parametru, zdrojový sloupec, DataRowVersion použití a hodnotu parametru. |
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, délku parametru směr, přesnost, měřítko, název zdrojového sloupce, jednu z DataRowVersion hodnot, logickou hodnotu pro mapování zdrojového sloupce, hodnotu |
SqlParameter()
Inicializuje novou instanci SqlParameter třídy.
public:
SqlParameter();
public SqlParameter ();
Public Sub New ()
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Viz také
Platí pro
SqlParameter(String, SqlDbType)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
Výjimky
Hodnota zadaná v parametru dbType
je neplatný datový typ back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Poznámky
Datový typ a v případě potřeby Velikost a Precision jsou odvozeny z hodnoty parametru dbType
.
Viz také
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET
Platí pro
SqlParameter(String, Object)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nového SqlParameter.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- value
- Object
To Object je hodnota SqlParameter.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Poznámky
Když zadáte Object v parametruvalue
, SqlDbType je odvozen z Microsoft .NET Framework typu Object.
Při použití tohoto přetížení konstruktoru SqlParameter k určení celočíselné hodnoty parametrů používejte upozornění. Vzhledem k tomu, že toto přetížení přebírá value
typ Object, je nutné převést integrální hodnotu na Object typ, pokud je hodnota nula, jak ukazuje následující příklad jazyka C#.
Parameter = new SqlParameter("@pname", (object)0);
Pokud tento převod neprovedete, kompilátor předpokládá, že se pokoušíte volat přetížení konstruktoru SqlParameter(String, SqlDbType) .
Viz také
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET
Platí pro
SqlParameter(String, SqlDbType, Int32)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, a SqlDbTypevelikost.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- size
- Int32
Délka parametru.
Výjimky
Hodnota zadaná v parametru dbType
je neplatný datový typ back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Poznámky
Velikost je odvozena z hodnoty parametrudbType
, pokud není explicitně nastavena v parametrusize
.
Viz také
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET
Platí pro
SqlParameter(String, SqlDbType, Int32, String)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, SqlDbTypevelikost a název zdrojového sloupce.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- size
- Int32
Délka parametru.
- sourceColumn
- String
Název zdrojového sloupce (SourceColumn), pokud se používá SqlParameter ve volání .Update
Výjimky
Hodnota zadaná v parametru dbType
je neplatný datový typ back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Poznámky
Velikost je odvozena z hodnoty parametrudbType
, pokud není explicitně nastavena v parametrusize
.
Viz také
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET
Platí pro
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, velikost parametru, přesnost parametru, ParameterDirectionměřítko parametru, zdrojový sloupec, DataRowVersion použití a hodnotu parametru.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- size
- Int32
Délka parametru.
- direction
- ParameterDirection
Jedna z ParameterDirection hodnot.
- isNullable
- Boolean
true
pokud hodnota pole může být null; false
v opačném případě .
- sourceColumn
- String
Název zdrojového sloupce (SourceColumn), pokud se používá SqlParameter ve volání .Update
- sourceVersion
- DataRowVersion
Jedna z DataRowVersion hodnot.
- value
- Object
To Object je hodnota SqlParameter.
Výjimky
Hodnota zadaná v parametru dbType
je neplatný datový typ back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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
Poznámky
Velikost a Precision jsou odvozeny z hodnoty parametrudbType
, pokud nejsou explicitně nastaveny v parametru size
a precision
parametry.
Viz také
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET
Platí pro
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru, typ parametru, délku parametru směr, přesnost, měřítko, název zdrojového sloupce, jednu z DataRowVersion hodnot, logickou hodnotu pro mapování zdrojového sloupce, hodnotu SqlParameter
, název databáze, kde se nachází kolekce schématu pro tuto instanci XML, vlastnící relační schéma, kde se nachází kolekce schémat pro tuto instanci XML, a název kolekce schémat pro tento parametr.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- size
- Int32
Délka parametru.
- direction
- ParameterDirection
Jedna z ParameterDirection hodnot.
- sourceColumn
- String
Název zdrojového sloupce (SourceColumn), pokud se používá SqlParameter ve volání .Update
- sourceVersion
- DataRowVersion
Jedna z DataRowVersion hodnot.
- sourceColumnNullMapping
- Boolean
true
pokud je zdrojový sloupec s možnou hodnotou null; false
pokud tomu tak není.
- value
- Object
To Object je hodnota SqlParameter.
- xmlSchemaCollectionDatabase
- String
Název databáze, ve které se nachází kolekce schémat pro tuto instanci XML.
- xmlSchemaCollectionOwningSchema
- String
Vlastnící relační schéma, ve kterém je umístěna kolekce schématu pro tuto instanci XML.
- xmlSchemaCollectionName
- String
Název kolekce schémat pro tento parametr.
Poznámky
Precision A Size jsou odvozeny z hodnoty parametrudbType
, pokud nejsou explicitně nastaveny v parametrech size
a precision
parametry.
Viz také
- Datové typy SQL Serveru a ADO.NET
- Příkazy a parametry (ADO.NET)
- Parametry datového adaptéru (ADO.NET)
- Použití .NET Framework Zprostředkovatel dat pro SQL Server
- Přehled ADO.NET