SqlParameter Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Představuje parametr pro SqlCommand a volitelně jeho mapování na DataSet sloupce. Tato třída se nemůže dědit. Další informace o parametrech naleznete v tématu Konfigurace parametrů a datových typů parametrů.

Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, 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

Dědičnost

Object

MarshalByRefObject

DbParameter

SqlParameter

Atributy

TypeConverterAttribute

Implementuje

IDataParameter IDbDataParameter ICloneable

Příklady

Následující příklad vytvoří více instancí SqlParameter prostřednictvím SqlParameterCollection kolekce v rámci .SqlDataAdapter Tyto parametry slouží k výběru dat ze zdroje dat a vložení dat do DataSet. V tomto příkladu se předpokládá, že již DataSetSqlDataAdapter byla vytvořena pomocí příslušného schématu, příkazů a připojení. Další informace a další příklady použití parametrů najdete v tématu Retrieving a úpravy dat v ADO.NET a Konfigurování 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.

Note

Zprostředkovatel dat rozhraní .NET Framework pro SQL Server nepodporuje parametry bez názvu, označované také jako pořadové číslo.

Další informace a další vzorový kód demonstrující použití parametrů najdete v tématu Příkazy a Parametry.

Konstruktory

Název	Description
SqlParameter()	Inicializuje novou instanci SqlParameter třídy. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlParameter(String, Object)	Inicializuje novou instanci SqlParameter třídy, která používá název parametru a hodnotu nové SqlParameter. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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 je umístěna kolekce schémat pro tuto instanci XML, vlastnící relační schéma, ve kterém se nachází kolekce schématu pro tuto instanci XML, a název kolekce schématu pro tento parametr. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Inicializuje novou instanci SqlParameter třídy, která používá název parametru SqlDbType, a velikost. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Inicializuje novou instanci SqlParameter třídy, která používá název parametru a datový typ. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Vlastnosti

Název	Description
CompareInfo	Získá nebo nastaví CompareInfo objekt, který definuje, jak se mají provádět porovnání řetězců pro tento parametr. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
DbType	Získá nebo nastaví SqlDbType parametr. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Direction	Získá nebo nastaví hodnotu, která určuje, zda je parametr pouze vstup, výstup-pouze, obousměrný nebo uložená procedura návratový parametr hodnoty. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
ForceColumnEncryption	Vynucuje šifrování parametru při použití funkce Always Encrypted. Pokud SQL Server informuje ovladač, že parametr nemusí být šifrovaný, dotaz pomocí parametru selže. Tato vlastnost poskytuje další ochranu před útoky na zabezpečení, které zahrnují ohroženou SQL Server poskytnutí nesprávných metadat šifrování klientovi, což může vést k vyzrazení dat. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IsNullable	Získá nebo nastaví hodnotu, která určuje, zda parametr přijímá hodnoty null. IsNullable se nepoužívá k ověření hodnoty parametru a při provádění příkazu nezabrání odeslání nebo přijetí hodnoty null. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
LocaleId	Získá nebo nastaví identifikátor národního prostředí, který určuje konvence a jazyk pro konkrétní oblast. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Offset	Získá nebo nastaví posun na Value vlastnost. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
ParameterName	Získá nebo nastaví název SqlParameter. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Precision	Získá nebo nastaví maximální počet číslic použitých k reprezentaci Value vlastnosti. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Scale	Získá nebo nastaví počet desetinných míst, na které Value se přeloží. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Size	Získá nebo nastaví maximální velikost dat v bajtech v rámci sloupce. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SourceColumn	Získá nebo nastaví název zdrojového sloupce mapovaného na DataSet a používá se k načtení nebo vrácení Value. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SourceColumnNullMapping	Získá nebo nastaví hodnotu, která označuje, zda zdrojový sloupec má hodnotu null. To umožňuje SqlCommandBuilder správně generovat příkazy Update pro sloupce s možnou hodnotou null. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SourceVersion	Získá nebo nastaví DataRowVersion použití při načítání Value. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlDbType	Získá nebo nastaví SqlDbType parametr. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlValue	Získá nebo nastaví hodnotu parametru jako typ SQL. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
TypeName	Získá nebo nastaví název typu pro parametr s hodnotou tabulky. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
UdtTypeName	Získá nebo nastaví string , který představuje uživatelem definovaný typ jako parametr. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Value	Získá nebo nastaví hodnotu parametru. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
XmlSchemaCollectionDatabase	Získá název databáze, kde je umístěna kolekce schémat pro tuto instanci XML. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
XmlSchemaCollectionName	Získá název kolekce schémat pro tuto instanci XML. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Vlastnící relační schéma, ve kterém je umístěna kolekce schématu pro tuto instanci XML. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Metody

Název	Description
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
ResetSqlDbType()	Obnoví typ přidružený k tomuto SqlParameter. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
ToString()	Získá řetězec, který obsahuje ParameterName. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Explicitní implementace rozhraní

Název	Description
ICloneable.Clone()	Popis tohoto člena naleznete v tématu Clone(). Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IDbDataParameter.Precision	Určuje přesnost číselných parametrů. (Zděděno od DbParameter)
IDbDataParameter.Scale	Popis tohoto člena naleznete v tématu Scale. (Zděděno od DbParameter)

Viz také

• SqlParameterCollection
• SqlCommand
• Příkazy a Parametry
• Parametry adaptéru dat
• SQL Server a ADO.NET
• Přehled ADO.NET