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.

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
[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
[<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
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Overname
Object
MarshalByRefObject
SqlParameter
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

Name Description
SqlParameter()

Initialiseert een nieuw exemplaar van de SqlParameter klasse.
SqlParameter(String, Object)

Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en een waarde van de nieuwe SqlParameter.
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.
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.
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.
SqlParameter(String, SqlDbType, Int32)

Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, de SqlDbTypeen de grootte.
SqlParameter(String, SqlDbType)

Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en het gegevenstype.

Eigenschappen

Name Description
CompareInfo

Hiermee wordt het CompareInfo object opgehaald of ingesteld waarmee wordt gedefinieerd hoe tekenreeksvergelijkingen moeten worden uitgevoerd voor deze parameter.
DbType

Hiermee haalt u de SqlDbType parameter op of stelt u deze in.
Direction

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de parameter alleen-invoer, alleen-uitvoer, bidirectioneel of een opgeslagen procedure retourwaardeparameter is.
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.
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.
LocaleId

Hiermee wordt de landinstellings-id opgehaald of ingesteld waarmee conventies en taal voor een bepaalde regio worden bepaald.
Offset

Hiermee haalt u de offset op of stelt u deze in op de Value eigenschap.
ParameterName

Hiermee haalt u de naam van de SqlParameter.
Precision

Hiermee haalt u het maximum aantal cijfers op dat wordt gebruikt om de Value eigenschap weer te geven.
Scale

Hiermee haalt u het aantal decimalen op of stelt u dit in.Value
Size

Hiermee wordt de maximale grootte, in bytes, van de gegevens in de kolom opgehaald of ingesteld.
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.
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.
SourceVersion

Hiermee haalt u het te gebruiken op of stelt u deze DataRowVersion in wanneer u laadt Value.
SqlDbType

Hiermee haalt u de SqlDbType parameter op of stelt u deze in.
SqlValue

Hiermee haalt u de waarde van de parameter op of stelt u deze in als een SQL-type.
TypeName

Hiermee haalt u de typenaam voor een parameter met tabelwaarde op of stelt u deze in.
UdtTypeName

Hiermee haalt u een op of stelt u een string die een door de gebruiker gedefinieerd type vertegenwoordigt als een parameter.
Value

Hiermee haalt u de waarde van de parameter op of stelt u deze in.
XmlSchemaCollectionDatabase

Hiermee haalt u de naam op van de database waarin de schemaverzameling voor dit XML-exemplaar zich bevindt.
XmlSchemaCollectionName

Hiermee haalt u de naam op van de schemaverzameling voor dit XML-exemplaar.
XmlSchemaCollectionOwningSchema

Het relationele schema waarin de schemaverzameling voor dit XML-exemplaar zich bevindt.

Methoden

Name 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.
ResetSqlDbType()

Hiermee stelt u het type opnieuw in dat aan dit SqlParametertype is gekoppeld.
ToString()

Hiermee haalt u een tekenreeks op die de ParameterName.

Expliciete interface-implementaties

Name Description
ICloneable.Clone()

Zie voor een beschrijving van dit lid Clone().
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)

Van toepassing op

Zie ook