SqlParameter Třída
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ředstavuje parametr objektu SqlCommand a volitelně jeho mapování na DataSet sloupce. Tato třída se nemůže dědit. Další informace o parametrech najdete v tématu Konfigurace parametrů a datových typů parametrů.
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
public ref class SqlParameter sealed : System::Data::Common::DbParameter
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
type SqlParameter = class
inherit DbParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
inherit DbParameter
interface ICloneable
type SqlParameter = class
inherit DbParameter
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
inherit MarshalByRefObject
interface IDbDataParameter
interface IDataParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
inherit DbParameter
interface IDbDataParameter
interface IDataParameter
interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
- Dědičnost
- Dědičnost
- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklad vytvoří více instancí objektu SqlParameterSqlParameterCollection prostřednictvím kolekce v rámci objektu SqlDataAdapter. Tyto parametry slouží k výběru dat ze zdroje dat a jejich vložení do DataSet. Tento příklad předpokládá, že DataSet objekty a a SqlDataAdapter již byly vytvořeny pomocí příslušného schématu, příkazů a připojení. Další informace a další příklady použití parametrů najdete v tématech Načítání a úpravy dat v ADO.NET a Konfigurace parametrů a datových typů parametrů.
public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...
categoriesAdapter.SelectCommand.Parameters.Add(
"@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
categoriesAdapter.SelectCommand.Parameters.Add(
"@SerialNum", SqlDbType.Int).Value = 239;
categoriesAdapter.Fill(categoriesDataSet);
}
Public Sub AddSqlParameters()
' ...
' create categoriesDataSet and categoriesAdapter
' ...
categoriesAdapter.SelectCommand.Parameters.Add( _
"@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
categoriesAdapter.SelectCommand.Parameters.Add( _
"@SerialNum", SqlDbType.Int).Value = 239
categoriesAdapter.Fill(categoriesDataSet)
End Sub
Poznámky
V názvech parametrů se nerozlišují malá a velká písmena.
Poznámka
Zprostředkovatel dat rozhraní .NET Framework nepodporuje parametry bez názvů, označované také jako řadové, pro SQL Server.
Další informace spolu s dalším ukázkovým kódem, který demonstruje použití parametrů, najdete v tématu Příkazy a parametry.
Konstruktory
SqlParameter() |
Inicializuje novou instanci SqlParameter třídy . |
SqlParameter(String, Object) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nové SqlParameter. |
SqlParameter(String, SqlDbType) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ. |
SqlParameter(String, SqlDbType, Int32) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost. |
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(String, SqlDbType, Int32, String) |
Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, velikost a název zdrojového sloupce. |
Vlastnosti
CompareInfo |
Získá nebo nastaví CompareInfo objekt, který definuje, jak by měly být provedeny porovnání řetězců pro tento parametr. |
DbType |
Získá nebo nastaví SqlDbType parametr . |
Direction |
Získá nebo nastaví hodnotu, která označuje, zda je parametr pouze vstup, pouze výstup, obousměrný nebo uložená procedura vrátit hodnotu parametru. |
ForceColumnEncryption |
Vynucuje šifrování parametru při použití Always Encrypted. Pokud SQL Server ovladač informuje, že parametr není nutné šifrovat, dotaz používající parametr selže. Tato vlastnost poskytuje dodatečnou ochranu před útoky na zabezpečení, které zahrnují ohrožené SQL Server poskytování nesprávných metadat šifrování klientovi, což může vést ke zpřístupnění dat. |
IsNullable |
Získá nebo nastaví hodnotu, která označuje, zda parametr přijímá hodnoty null. IsNullable se nepoužívá k ověření hodnoty parametru a nezabrání odeslání nebo přijetí hodnoty null při provádění příkazu. |
LocaleId |
Získá nebo nastaví identifikátor národního prostředí, který určuje konvence a jazyk pro konkrétní oblast. |
Offset |
Získá nebo nastaví posun vlastnosti Value . |
ParameterName |
Získá nebo nastaví název objektu SqlParameter. |
Precision |
Získá nebo nastaví maximální počet číslic použitých k reprezentaci Value vlastnosti. |
Scale |
Získá nebo nastaví počet desetinných míst, která Value je přeložena. |
Size |
Získá nebo nastaví maximální velikost dat v bajtech v rámci sloupce. |
SourceColumn |
Získá nebo nastaví název zdrojového sloupce mapovaného na DataSet a slouží k načtení nebo vrácení Value. |
SourceColumnNullMapping |
Získá nebo nastaví hodnotu, která označuje, zda zdrojový sloupec je nullable. To umožňuje SqlCommandBuilder správně generovat příkazy Update pro sloupce s možnou hodnotou null. |
SourceVersion |
Získá nebo nastaví na DataRowVersion použití při načtení Value. |
SourceVersion |
Získá nebo nastaví na DataRowVersion použití při načtení Value. (Zděděno od DbParameter) |
SqlDbType |
Získá nebo nastaví SqlDbType parametr . |
SqlValue |
Získá nebo nastaví hodnotu parametru jako typ SQL. |
TypeName |
Získá nebo nastaví název typu parametru s hodnotou tabulky. |
UdtTypeName |
Získá nebo nastaví , |
Value |
Získá nebo nastaví hodnotu parametru. |
XmlSchemaCollectionDatabase |
Získá název databáze, ve které se nachází kolekce schématu pro tuto instanci XML. |
XmlSchemaCollectionName |
Získá název kolekce schématu pro tuto instanci XML. |
XmlSchemaCollectionOwningSchema |
Vlastnící relační schéma, kde se nachází kolekce schémat pro tuto instanci XML. |
Metody
CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetLifetimeService() |
Zastaralé.
Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
InitializeLifetimeService() |
Zastaralé.
Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
ResetDbType() |
Obnoví typ přidružený k tomuto SqlParameter. |
ResetSqlDbType() |
Obnoví typ přidružený k tomuto SqlParameter. |
ToString() |
Získá řetězec, který obsahuje ParameterName. |
Explicitní implementace rozhraní
ICloneable.Clone() |
Popis tohoto člena najdete v tématu Clone(). |
IDataParameter.SourceVersion |
Získá nebo nastaví na DataRowVersion použití při načítání Value. (Zděděno od DbParameter) |
IDbDataParameter.Precision |
Označuje přesnost číselných parametrů. (Zděděno od DbParameter) |
IDbDataParameter.Scale |
Popis tohoto člena najdete v tématu Scale. (Zděděno od DbParameter) |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro