SqlParameter Třída

Definice

Představuje parametr pro SqlCommand a volitelně mapování na DataSet sloupce.Represents a parameter to a SqlCommand and optionally its mapping to DataSet columns. Tuto třídu nelze zdědit.This class cannot be inherited. Další informace o parametrech najdete v tématu Konfigurace parametrů a datových typů parametrů.For more information on parameters, see Configuring Parameters and Parameter Data Types.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
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
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
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 kolekce SqlParameterCollection v rámci SqlDataAdapter.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection within the SqlDataAdapter. Tyto parametry slouží k výběru dat ze zdroje dat a vložení dat do DataSet.These parameters are used to select data from the data source and put the data in the DataSet. Tento příklad předpokládá, že DataSet a SqlDataAdapter již byly vytvořeny pomocí příslušného schématu, příkazů a připojení.This example assumes that a DataSet and a SqlDataAdapter have already been created by using the appropriate schema, commands, and connection. Další informace a další příklady použití parametrů naleznete v tématu načítání a úpravy dat v ADO.NET a Konfigurace parametrů a datových typů parametrů.For more information and additional examples on using parameters, see Retrieving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Data Types.

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

U názvů parametrů se nerozlišují malá a velká písmena.Parameter names are not case sensitive.

Poznámka

Nameless Zprostředkovatel dat pro SQL Server nepodporuje .NET Framework, které jsou označovány také jako ordinální, parametry.Nameless, also called ordinal, parameters are not supported by the .NET Framework Data Provider for SQL Server.

Další informace spolu s dalšími vzorovými kódy, které demonstrují, jak používat parametry, naleznete v tématu Commands and Parameters.For more information, along with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Konstruktory

SqlParameter()

Inicializuje novou instanci třídy SqlParameter.Initializes a new instance of the SqlParameter class.

SqlParameter(String, Object)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru a hodnotu nového SqlParameter.Initializes a new instance of the SqlParameter class that uses the parameter name and a value of the new SqlParameter.

SqlParameter(String, SqlDbType)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru a datový typ.Initializes a new instance of the SqlParameter class that uses the parameter name and the data type.

SqlParameter(String, SqlDbType, Int32)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru, SqlDbTypea velikost.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, and the size.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru, typ parametru, velikost parametru, ParameterDirection, přesnost parametru, měřítko parametru, zdrojový sloupec, DataRowVersion, který se má použít, a hodnotu parametru.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the size of the parameter, a ParameterDirection, the precision of the parameter, the scale of the parameter, the source column, a DataRowVersion to use, and the value of the parameter.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru, typ parametru, délku parametru směr, přesnost, měřítko, název zdrojového sloupce, jedna z DataRowVersionch hodnot, logická hodnota pro mapování zdrojového sloupce, hodnota SqlParameter, název databáze, ve které je umístěna kolekce schématu pro tuto instanci XML, vlastnící relační schéma, kde je umístěna kolekce schématu pro tuto instanci XML, a název kolekce schématu pro tento parametr.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the length of the parameter the direction, the precision, the scale, the name of the source column, one of the DataRowVersion values, a Boolean for source column mapping, the value of the SqlParameter, the name of the database where the schema collection for this XML instance is located, the owning relational schema where the schema collection for this XML instance is located, and the name of the schema collection for this parameter.

SqlParameter(String, SqlDbType, Int32, String)

Inicializuje novou instanci třídy SqlParameter, která používá název parametru, SqlDbType, velikost a název zdrojového sloupce.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, the size, and the source column name.

Vlastnosti

CompareInfo

Získá nebo nastaví objekt CompareInfo, který definuje, jak by měla být provedena porovnávání řetězců pro tento parametr.Gets or sets the CompareInfo object that defines how string comparisons should be performed for this parameter.

DbType

Získá nebo nastaví SqlDbType parametru.Gets or sets the SqlDbType of the parameter.

Direction

Získává nebo nastavuje hodnotu, která indikuje, jestli je parametr zadaný jako parametr, který vrací hodnotu pouze pro výstup, obousměrný nebo uloženou proceduru.Gets or sets a value that indicates whether the parameter is input-only, output-only, bidirectional, or a stored procedure return value parameter.

ForceColumnEncryption

Vynutila šifrování parametru při použití Always Encrypted.Enforces encryption of a parameter when using Always Encrypted. Pokud SQL Server informuje ovladač o tom, že parametr není nutné šifrovat, dotaz používající parametr selže.If SQL Server informs the driver that the parameter does not need to be encrypted, the query using the parameter will fail. Tato vlastnost poskytuje dodatečnou ochranu proti bezpečnostním útokům, které zahrnují ohrožený SQL Server poskytování nesprávných šifrovacích metadat klientovi, což může vést k odhalení dat.This property provides additional protection against security attacks that involve a compromised SQL Server providing incorrect encryption metadata to the client, which may lead to data disclosure.

IsNullable

Získává nebo nastavuje hodnotu, která indikuje, jestli parametr přijímá hodnoty null.Gets or sets a value that indicates whether the parameter accepts null values. 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.IsNullable is not used to validate the parameter's value and will not prevent sending or receiving a null value when executing a command.

LocaleId

Získá nebo nastaví identifikátor národního prostředí, který určuje konvence a jazyk pro konkrétní oblast.Gets or sets the locale identifier that determines conventions and language for a particular region.

Offset

Získá nebo nastaví posunutí na vlastnost Value.Gets or sets the offset to the Value property.

ParameterName

Získá nebo nastaví název SqlParameter.Gets or sets the name of the SqlParameter.

Precision

Získá nebo nastaví maximální počet číslic, které slouží k reprezentaci vlastnosti Value.Gets or sets the maximum number of digits used to represent the Value property.

Scale

Získá nebo nastaví počet desetinných míst, na které je Value vyřešen.Gets or sets the number of decimal places to which Value is resolved.

Size

Získá nebo nastaví maximální velikost dat ve sloupci v bajtech.Gets or sets the maximum size, in bytes, of the data within the column.

SourceColumn

Získá nebo nastaví název zdrojového sloupce namapovaného na DataSet a používá se k načtení nebo vrácení Value.Gets or sets the name of the source column mapped to the DataSet and used for loading or returning the Value

SourceColumnNullMapping

Získává nebo nastavuje hodnotu, která indikuje, jestli zdrojový sloupec může mít hodnotu null.Gets or sets a value which indicates whether the source column is nullable. To umožňuje SqlCommandBuilder správně Generovat příkazy aktualizace pro sloupce s možnou hodnotou null.This allows SqlCommandBuilder to correctly generate Update statements for nullable columns.

SourceVersion

Získá nebo nastaví DataRowVersion, který se použije při načítání ValueGets or sets the DataRowVersion to use when you load Value

SqlDbType

Získá nebo nastaví SqlDbType parametru.Gets or sets the SqlDbType of the parameter.

SqlValue

Získá nebo nastaví hodnotu parametru jako typ SQL.Gets or sets the value of the parameter as an SQL type.

TypeName

Získá nebo nastaví název typu pro parametr s hodnotou tabulky.Gets or sets the type name for a table-valued parameter.

UdtTypeName

Získá nebo nastaví string, který představuje uživatelsky definovaný typ jako parametr.Gets or sets a string that represents a user-defined type as a parameter.

Value

Získá nebo nastaví hodnotu parametru.Gets or sets the value of the parameter.

XmlSchemaCollectionDatabase

Získá název databáze, ve které je umístěno shromažďování schémat této instance XML.Gets the name of the database where the schema collection for this XML instance is located.

XmlSchemaCollectionName

Získá název kolekce schémat pro tuto instanci XML.Gets the name of the schema collection for this XML instance.

XmlSchemaCollectionOwningSchema

Vlastnící relační schéma, kde se nachází kolekce schématu pro tuto instanci XML.The owning relational schema where the schema collection for this XML instance is located.

Metody

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Zděděno od MarshalByRefObject)
Equals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetLifetimeService()

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Získá Type aktuální instance.Gets the Type of the current instance.

(Zděděno od Object)
InitializeLifetimeService()

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu MarshalByRefObject bez podstruktury.Creates a shallow copy of the current MarshalByRefObject object.

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

Obnoví typ přidružený k tomuto SqlParameter.Resets the type associated with this SqlParameter.

ResetSqlDbType()

Obnoví typ přidružený k tomuto SqlParameter.Resets the type associated with this SqlParameter.

ToString()

Načte řetězec, který obsahuje ParameterName.Gets a string that contains the ParameterName.

Explicitní implementace rozhraní

ICloneable.Clone()

Popis tohoto člena naleznete v tématu Clone().For a description of this member, see Clone().

IDataParameter.SourceVersion (Zděděno od DbParameter)
IDbDataParameter.Precision

Určuje přesnost číselných parametrů.Indicates the precision of numeric parameters.

(Zděděno od DbParameter)
IDbDataParameter.Scale

Popis tohoto člena naleznete v tématu Scale.For a description of this member, see Scale.

(Zděděno od DbParameter)

Platí pro

Viz také