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í.
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é SqlParameter. |
SqlParameter(String, SqlDbType, Int32) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost. |
SqlParameter(String, SqlDbType, Int32, String) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, velikost 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, ParameterDirectiona , přesnost parametru, měřítko parametru, zdrojový sloupec, DataRowVersion použít 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 |
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.
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);
}
}
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.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ým datovým typem back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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);
}
}
Poznámky
Datový typ a případně Velikost a Precision se odvozují z hodnoty parametru dbType
.
Platí pro
SqlParameter(String, Object)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nové SqlParameter.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- value
- Object
Jedná Object se o hodnotu SqlParameter.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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);
}
}
Poznámky
Když v parametru Objectvalue
zadáte , SqlDbType je odvozena z rozhraní Microsoft .NET Framework typu Object.
Při použití tohoto přetížení konstruktoru SqlParameter k určení hodnot celočíselných parametrů buďte opatrní. Vzhledem k tomu, že toto přetížení přijímá value
Objecttyp , musíte při nulové hodnotě převést celočíselnou hodnotu na Object typ, 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) .
Platí pro
SqlParameter(String, SqlDbType, Int32)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost.
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)
Parametry
- parameterName
- String
Název parametru, který se má mapovat.
- size
- Int32
Délka parametru
Výjimky
Hodnota zadaná v parametru dbType
je neplatným datovým typem back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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);
}
}
Poznámky
Velikost se odvodí z hodnoty parametru dbType
, pokud není explicitně nastavená v parametru size
.
Platí pro
SqlParameter(String, SqlDbType, Int32, String)
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, velikost 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 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)
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 SqlParameter používá při volání .Update(DataSet)>
Výjimky
Hodnota zadaná v parametru dbType
je neplatným datovým typem back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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);
}
}
Poznámky
Velikost se odvodí z hodnoty parametru dbType
, pokud není explicitně nastavená v parametru size
.
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, ParameterDirectiona , přesnost parametru, měřítko parametru, zdrojový sloupec, DataRowVersion použít 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 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)
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; v opačném případě . false
- sourceColumn
- String
Název zdrojového sloupce (SourceColumn), pokud se SqlParameter používá při volání .Update(DataSet)
- sourceVersion
- DataRowVersion
Jedna z DataRowVersion hodnot.
- value
- Object
Jedná Object se o hodnotu SqlParameter.
Výjimky
Hodnota zadaná v parametru dbType
je neplatným datovým typem back-endu.
Příklady
Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.
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);
}
}
Poznámky
Size a Precision jsou odvozeny z hodnoty parametrudbType
, pokud nejsou explicitně nastaveny v parametrech size
a precision
.
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 SqlParameter
sloupce, hodnotu , název databáze, ve které se nachází kolekce schémat pro tuto instanci XML, vlastnící relační schéma, kde je umístěna 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 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)
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 SqlParameter používá při volání .Update(DataSet)>
- sourceVersion
- DataRowVersion
Jedna z DataRowVersion hodnot.
- sourceColumnNullMapping
- Boolean
true
Pokud zdrojový sloupec je nullable; false
pokud není.
- value
- Object
Jedná Object se o hodnotu SqlParameter.
- xmlSchemaCollectionDatabase
- String
Název databáze, ve které je umístěna kolekce schémat pro tuto instanci XML.
- xmlSchemaCollectionOwningSchema
- String
Vlastnící relační schéma, kde je umístěna kolekce schémat pro tuto instanci XML.
- xmlSchemaCollectionName
- String
Název kolekce schémat pro tento parametr.
Poznámky
Hodnoty Size a Precision jsou odvozeny z hodnoty parametru dbType
, pokud nejsou explicitně nastaveny v parametrech size
a precision
.