SqlParameter Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

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

[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

DbParameter

SqlParameter

Atributy

TypeConverterAttribute

Implementuje

ICloneable IDataParameter IDbDataParameter

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 SqlParametersloupce, 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.
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.
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.
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í , string který představuje uživatelem definovaný typ jako parametr.
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

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)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
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().

Viz také

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