SqlParameter Klas

Definitie

Naamruimte:

System.Data.SqlClient

Assembly:

System.Data.dll

Vertegenwoordigt een parameter voor een SqlCommand en optioneel de toewijzing aan DataSet kolommen. Deze klasse kan niet worden overgenomen. Zie Parameters en parametergegevenstypen configureren voor meer informatie over parameters.

Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde 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

Overname

Object

MarshalByRefObject

DbParameter

SqlParameter

Kenmerken

TypeConverterAttribute

Implementeringen

IDataParameter IDbDataParameter ICloneable

Voorbeelden

In het volgende voorbeeld worden meerdere exemplaren gemaakt van SqlParameter via de SqlParameterCollection verzameling in de SqlDataAdapter. Deze parameters worden gebruikt om gegevens uit de gegevensbron te selecteren en de gegevens in de DataSet. In dit voorbeeld wordt ervan uitgegaan dat een DataSet en een SqlDataAdapter al zijn gemaakt met behulp van het juiste schema, opdrachten en verbinding. Zie Replicaving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Data Types voor meer informatie en aanvullende voorbeelden van het gebruik van parameters.

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

Opmerkingen

Parameternamen zijn niet hoofdlettergevoelig.

Note

Naamloze parameters, ook wel ordinaal genoemd, worden niet ondersteund door de .NET Framework-Data Provider voor SQL Server.

Zie Opdrachten en parameters voor meer informatie, samen met aanvullende voorbeeldcode die laat zien hoe u parameters gebruikt.

Constructors

Naam	Description
SqlParameter()	Initialiseert een nieuw exemplaar van de SqlParameter klasse. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, Object)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en een waarde van de nieuwe SqlParameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, het type parameter, de grootte van de parameter, een ParameterDirection, de precisie van de parameter, de schaal van de parameter, de bronkolom, een DataRowVersion te gebruiken en de waarde van de parameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, het type parameter, de lengte van de parameter in de richting, de precisie, de schaal, de naam van de bronkolom, een van de DataRowVersion waarden, een Booleaanse waarde voor bronkolomtoewijzing, de waarde van de SqlParameterdatabase waarin de schemaverzameling voor dit XML-exemplaar zich bevindt, het relationele schema waarin de schemaverzameling voor dit XML-exemplaar zich bevindt en de naam van de schemaverzameling voor deze parameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, de SqlDbTypegrootte en de naam van de bronkolom. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, de SqlDbTypeen de grootte. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en het gegevenstype. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.

Eigenschappen

Naam	Description
CompareInfo	Hiermee wordt het CompareInfo object opgehaald of ingesteld waarmee wordt gedefinieerd hoe tekenreeksvergelijkingen moeten worden uitgevoerd voor deze parameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
DbType	Hiermee haalt u de SqlDbType parameter op of stelt u deze in. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Direction	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de parameter alleen-invoer, alleen-uitvoer, bidirectioneel of een opgeslagen procedure retourwaardeparameter is. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
ForceColumnEncryption	Hiermee wordt versleuteling van een parameter afgedwongen bij gebruik van Always Encrypted. Als SQL Server het stuurprogramma informeert dat de parameter niet hoeft te worden versleuteld, mislukt de query met behulp van de parameter. Deze eigenschap biedt extra bescherming tegen beveiligingsaanvallen waarbij een aangetaste SQL Server onjuiste versleutelingsmetagegevens aan de client levert, wat kan leiden tot openbaarmaking van gegevens. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
IsNullable	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de parameter null-waarden accepteert. IsNullable wordt niet gebruikt om de waarde van de parameter te valideren en voorkomt niet dat een null-waarde wordt verzonden of ontvangen bij het uitvoeren van een opdracht. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
LocaleId	Hiermee wordt de landinstellings-id opgehaald of ingesteld waarmee conventies en taal voor een bepaalde regio worden bepaald. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Offset	Hiermee haalt u de offset op of stelt u deze in op de Value eigenschap. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
ParameterName	Hiermee haalt u de naam van de SqlParameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Precision	Hiermee haalt u het maximum aantal cijfers op dat wordt gebruikt om de Value eigenschap weer te geven. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Scale	Hiermee haalt u het aantal decimalen op of stelt u dit in.Value Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Size	Hiermee wordt de maximale grootte, in bytes, van de gegevens in de kolom opgehaald of ingesteld. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SourceColumn	Hiermee haalt u de naam op van de bronkolom die is toegewezen aan de DataSet en wordt gebruikt voor het laden of retourneren van de Valuekolom. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SourceColumnNullMapping	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de bronkolom nullable is. Hierdoor kunnen SqlCommandBuilder update-instructies correct worden gegenereerd voor null-kolommen. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SourceVersion	Hiermee haalt u het te gebruiken op of stelt u deze DataRowVersion in wanneer u laadt Value. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlDbType	Hiermee haalt u de SqlDbType parameter op of stelt u deze in. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
SqlValue	Hiermee haalt u de waarde van de parameter op of stelt u deze in als een SQL-type. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
TypeName	Hiermee haalt u de typenaam voor een parameter met tabelwaarde op of stelt u deze in. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
UdtTypeName	Hiermee haalt u een op of stelt u een string die een door de gebruiker gedefinieerd type vertegenwoordigt als een parameter. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
Value	Hiermee haalt u de waarde van de parameter op of stelt u deze in. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
XmlSchemaCollectionDatabase	Hiermee haalt u de naam op van de database waarin de schemaverzameling voor dit XML-exemplaar zich bevindt. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
XmlSchemaCollectionName	Hiermee haalt u de naam op van de schemaverzameling voor dit XML-exemplaar. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Het relationele schema waarin de schemaverzameling voor dit XML-exemplaar zich bevindt. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.

Methoden

Naam	Description
CreateObjRef(Type)	Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLifetimeService()	Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
InitializeLifetimeService()	Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MemberwiseClone(Boolean)	Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject)
ResetDbType()	Hiermee stelt u het type opnieuw in dat aan dit SqlParametertype is gekoppeld. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
ResetSqlDbType()	Hiermee stelt u het type opnieuw in dat aan dit SqlParametertype is gekoppeld. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
ToString()	Hiermee haalt u een tekenreeks op die de ParameterName. Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.

Expliciete interface-implementaties

Naam	Description
ICloneable.Clone()	Zie voor een beschrijving van dit lid Clone(). Gebruik Microsoft voor nieuwe ontwikkeling. Data.SqlClient. Deze pagina documenteerde System.Data.SqlClient.
IDbDataParameter.Precision	Geeft de precisie van numerieke parameters aan. (Overgenomen van DbParameter)
IDbDataParameter.Scale	Zie voor een beschrijving van dit lid Scale. (Overgenomen van DbParameter)

Zie ook

• SqlParameterCollection
• SqlCommand
• Opdrachten en parameters
• DataAdapter-parameters
• SQL Server en ADO.NET
• overzicht van ADO.NET