SqlParameter Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Egy paramétert jelöl egy SqlCommand adott paraméterhez, és opcionálisan az oszlopokhoz való leképezését DataSet . Ez az osztály nem örökölhető. A paraméterekkel kapcsolatos további információkért lásd: Paraméterek és paraméteradattípusok konfigurálása.

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

Öröklődés

Object

MarshalByRefObject

DbParameter

SqlParameter

Attribútumok

TypeConverterAttribute

Megvalósítás

IDataParameter IDbDataParameter ICloneable

Példák

Az alábbi példa több példányt SqlParameter hoz létre a SqlParameterCollection gyűjteményen belül SqlDataAdapter. Ezek a paraméterek az adatforrásból származó adatok kiválasztására és az adatok elhelyezésére szolgálnak.DataSet Ez a példa feltételezi, hogy egy DataSet és egy SqlDataAdapter már létrejött a megfelelő sémával, parancsokkal és kapcsolattal. További információ és további példák a paraméterek használatáról: Ado.NET és Konfigurációs paraméterek és paraméteradattípusok.

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

Megjegyzések

A paraméternevek nem megkülönböztetik a kis- és nagybetűket.

Note

A névtelen, más néven sorszámú paramétereket a .NET-keretrendszer Data Provider nem támogatja SQL Server.

További információ, valamint a paraméterek használatát bemutató további mintakód: Parancsok és paraméterek.

Konstruktorok

Name	Description
SqlParameter()	Inicializálja a SqlParameter osztály új példányát.
SqlParameter(String, Object)	Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az új SqlParameterértéket használja.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, típusát, a paraméter méretét, ParameterDirectiona paraméter pontosságát, a paraméter skáláját, a forrásoszlopot DataRowVersion , a használandó értéket és a paraméter értékét használja.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Inicializálja annak az osztálynak az SqlParameter új példányát, amely a paraméter nevét, a paraméter típusát, az irányt, a pontosságot, a skálát, a forrásoszlop nevét, az értékek egyikét DataRowVersion , a forrásoszlop-leképezés logikai értékét, a SqlParameterparaméter értékét, annak az adatbázisnak a nevét használja, amelyben az XML-példány sémagyűjteménye található, a tulajdonos relációs sémát, ahol az XML-példány sémagyűjteménye található, és a paraméter sémagyűjteményének neve.
SqlParameter(String, SqlDbType, Int32, String)	Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a SqlDbTypeméretet és a forrásoszlop nevét használja.
SqlParameter(String, SqlDbType, Int32)	Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét, a méretet és a SqlDbTypeparaméter nevét használja.
SqlParameter(String, SqlDbType)	Inicializálja az SqlParameter osztály új példányát, amely a paraméter nevét és az adattípust használja.

Tulajdonságok

Name	Description
CompareInfo	Lekéri vagy beállítja azt az CompareInfo objektumot, amely meghatározza, hogyan kell sztring-összehasonlításokat végezni ehhez a paraméterhez.
DbType	Lekéri vagy beállítja a SqlDbType paramétert.
Direction	Lekéri vagy beállít egy értéket, amely jelzi, hogy a paraméter csak bemeneti, kimeneti, kétirányú vagy tárolt eljárás visszatérési érték paramétere-e.
ForceColumnEncryption	Az Always Encrypted használatakor kényszeríti egy paraméter titkosítását. Ha SQL Server tájékoztatja az illesztőprogramot, hogy a paramétert nem kell titkosítani, a paramétert használó lekérdezés sikertelen lesz. Ez a tulajdonság további védelmet nyújt az olyan biztonsági támadások ellen, amelyek sérült SQL Server helytelen titkosítási metaadatokat biztosítanak az ügyfél számára, ami adatfeltárást eredményezhet.
IsNullable	Lekéri vagy beállít egy értéket, amely jelzi, hogy a paraméter elfogadja-e a null értékeket. IsNullable nem a paraméter értékének ellenőrzésére szolgál, és nem akadályozza meg a null érték küldését vagy fogadását a parancs végrehajtásakor.
LocaleId	Lekéri vagy beállítja az adott régió konvencióit és nyelvét meghatározó területi azonosítót.
Offset	Lekéri vagy beállítja az eltolást a Value tulajdonságra.
ParameterName	Lekéri vagy beállítja a SqlParameternevét.
Precision	Lekéri vagy beállítja a tulajdonság megjelenítéséhez Value használt számjegyek maximális számát.
Scale	Lekéri vagy beállítja a feloldott tizedesjegyek Value számát.
Size	Lekéri vagy beállítja az oszlopban lévő adatok maximális méretét bájtban.
SourceColumn	Lekéri vagy beállítja annak a forrásoszlopnak a nevét, amely megfeleltethető a DataSet forrásoszlopnak, és a betöltéshez vagy a Valuevisszatéréshez használatos.
SourceColumnNullMapping	Lekéri vagy beállít egy értéket, amely jelzi, hogy a forrásoszlop null értékű-e. Ez lehetővé teszi SqlCommandBuilder , hogy helyesen hozzon létre frissítési utasításokat a null értékű oszlopokhoz.
SourceVersion	Betöltéskor DataRowVersionlekéri vagy beállítja a Value használni kívánt elemet.
SqlDbType	Lekéri vagy beállítja a SqlDbType paramétert.
SqlValue	Lekéri vagy beállítja a paraméter értékét SQL-típusként.
TypeName	Lekéri vagy beállítja egy táblaértékű paraméter típusnevét.
UdtTypeName	Lekéri vagy beállít egy string felhasználó által definiált típust paraméterként.
Value	Lekéri vagy beállítja a paraméter értékét.
XmlSchemaCollectionDatabase	Lekéri annak az adatbázisnak a nevét, amelyben az XML-példány sémagyűjteménye található.
XmlSchemaCollectionName	Lekéri az XML-példány sémagyűjteményének nevét.
XmlSchemaCollectionOwningSchema	A tulajdonos relációs séma, ahol az XML-példány sémagyűjteménye található.

Metódusok

Name	Description
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
ResetDbType()	Alaphelyzetbe állítja az ehhez a típushoz társított típust SqlParameter.
ResetSqlDbType()	Alaphelyzetbe állítja az ehhez a típushoz társított típust SqlParameter.
ToString()	Lekéri a sztringet, amely tartalmazza a ParameterName.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .
IDbDataParameter.Precision	A numerikus paraméterek pontosságát jelzi. (Öröklődés forrása DbParameter)
IDbDataParameter.Scale	Ennek a tagnak a leírását lásd Scale: . (Öröklődés forrása DbParameter)

Lásd még

• SqlParameterCollection
• SqlCommand
• Parancsok és paraméterek
• DataAdapter-paraméterek
• SQL Server és ADO.NET
• ADO.NET áttekintése