Sdílet prostřednictvím


SqlParameter Třída

Definice

Představuje parametr a SqlCommand 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
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : 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
[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, 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
type SqlParameter = class
    inherit DbParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Dědičnost
SqlParameter
Dědičnost
Dědičnost
SqlParameter
Atributy
Implementuje

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 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 malá písmena.

Poznámka

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

Další informace spolu s dalším ukázkovým kódem, který ukazuje, jak používat parametry, 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, ve kterém 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 parametr je pouze vstup, pouze výstup, obousměrný nebo uložená procedura vrátit hodnotu parametru.

ForceColumnEncryption

Vynucuje šifrování parametru při použití funkce Always Encrypted. Pokud SQL Server informuje ovladač, ž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 poskytující klientovi nesprávná metadata šifrování, 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 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, na které Value se přeloží.

Size

Získá nebo nastaví maximální velikost dat ve sloupci v bajtech.

SourceColumn

Získá nebo nastaví název zdrojového sloupce mapovaného na DataSet a použije se k načtení nebo vrácení Value.

SourceColumnNullMapping

Získá nebo nastaví hodnotu, která označuje, zda zdrojový sloupec je null. To umožňuje SqlCommandBuilder správně generovat příkazy Update pro sloupce s možnou hodnotou null.

SourceVersion

Získá nebo nastaví DataRowVersion na použití při načtení Value.

SourceVersion

Získá nebo nastaví DataRowVersion na 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 pro parametr s hodnotou tabulky.

UdtTypeName

Získá nebo nastaví typ string , který představuje typ definovaný uživatelem jako parametr.

Value

Získá nebo nastaví hodnotu parametru.

XmlSchemaCollectionDatabase

Získá název databáze, kde se nachází kolekce schémat pro tuto instanci XML.

XmlSchemaCollectionName

Získá název kolekce schémat 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 používaného 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 objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, 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é