SqlParameter Constructors

Definitie

Naamruimte:: System.Data.SqlClient

Assembly:: System.Data.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de SqlParameter klasse.

Overloads

Name	Description
SqlParameter()	Initialiseert een nieuw exemplaar van de SqlParameter klasse.
SqlParameter(String, SqlDbType)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en het gegevenstype.
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)	Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, de SqlDbTypeen de grootte.
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, 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 `SqlParameter`database 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()

Initialiseert een nieuw exemplaar van de SqlParameter klasse.

public:
 SqlParameter();

public SqlParameter();

Public Sub New ()

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter();
    parameter.ParameterName = "@Description";
    parameter.IsNullable = true;
    parameter.SqlDbType = SqlDbType.VarChar;
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = 88;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

Zie ook

Van toepassing op

SqlParameter(String, SqlDbType)

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

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter(string parameterName, System.Data.SqlDbType dbType);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

dbType: SqlDbType

Een van de SqlDbType waarden.

Uitzonderingen

ArgumentException

De waarde die in de parameter wordt opgegeven, is een ongeldig gegevenstype voor de dbType back-end.

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command, string paramValue)
{
    SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = 88;
    parameter.Value = paramValue;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Opmerkingen

Het gegevenstype en, indien van toepassing, grootte en Precision worden afgeleid van de waarde van de dbType parameter.

Zie ook

Van toepassing op

SqlParameter(String, Object)

Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam en een waarde van de nieuwe SqlParameter.

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter(string parameterName, object value);

new System.Data.SqlClient.SqlParameter : string * obj -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

value: Object

Een Object die de waarde is van de SqlParameter.

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88, "Description");
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Opmerkingen

Wanneer u een Object opgeeft in de parameter value, wordt de SqlDbType afgeleid van het Microsoft .NET type van de Object.

Wees voorzichtig wanneer u deze overbelasting van de SqlParameter constructor gebruikt om parameterwaarden voor gehele getallen op te geven. Omdat deze overbelasting een value type Objectheeft, moet u de integrale waarde converteren naar een Object type wanneer de waarde nul is, zoals in het volgende C#-voorbeeld wordt getoond.

Parameter = new SqlParameter("@pname", (object)0);

Als u deze conversie niet uitvoert, gaat de compiler ervan uit dat u de overbelasting van de SqlParameter(String, SqlDbType) constructor probeert aan te roepen.

Zie ook

Van toepassing op

SqlParameter(String, SqlDbType, Int32)

Initialiseert een nieuw exemplaar van de SqlParameter klasse die gebruikmaakt van de parameternaam, de SqlDbTypeen de grootte.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);

public SqlParameter(string parameterName, System.Data.SqlDbType dbType, int size);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

dbType: SqlDbType

Een van de SqlDbType waarden.

size: Int32

De lengte van de parameter.

Uitzonderingen

ArgumentException

De waarde die in de parameter wordt opgegeven, is een ongeldig gegevenstype voor de dbType back-end.

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command,
    string paramValue)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88);
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;
    parameter.Value = paramValue;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Opmerkingen

De grootte wordt afgeleid van de waarde van de dbType parameter als deze niet expliciet is ingesteld in de size parameter.

Zie ook

Van toepassing op

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);

public SqlParameter(string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

dbType: SqlDbType

Een van de SqlDbType waarden.

size: Int32

De lengte van de parameter.

sourceColumn: String

De naam van de bronkolom (SourceColumn) als deze SqlParameter wordt gebruikt in een aanroep naar Update.

Uitzonderingen

ArgumentException

De waarde die in de parameter wordt opgegeven, is een ongeldig gegevenstype voor de dbType back-end.

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 88, "Description");
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Opmerkingen

De grootte wordt afgeleid van de waarde van de dbType parameter als deze niet expliciet is ingesteld in de size parameter.

Zie ook

Van toepassing op

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);

public SqlParameter(string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

dbType: SqlDbType

Een van de SqlDbType waarden.

size: Int32

De lengte van de parameter.

direction: ParameterDirection

Een van de ParameterDirection waarden.

isNullable: Boolean

true als de waarde van het veld null kan zijn; anders, false.

precision: Byte

Het totale aantal cijfers links en rechts van het decimaalteken waarnaar Value wordt omgezet.

scale: Byte

Het totale aantal decimalen waarnaar Value wordt omgezet.

sourceColumn: String

De naam van de bronkolom (SourceColumn) als deze SqlParameter wordt gebruikt in een aanroep naar Update.

sourceVersion: DataRowVersion

Een van de DataRowVersion waarden.

value: Object

Een Object die de waarde is van de SqlParameter.

Uitzonderingen

ArgumentException

De waarde die in de parameter wordt opgegeven, is een ongeldig gegevenstype voor de dbType back-end.

Voorbeelden

In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description",
        SqlDbType.VarChar, 11, ParameterDirection.Input,
        true, 0, 0, "Description", DataRowVersion.Current,
        "garden hose");
    parameter.IsNullable = true;

    command.Parameters.Add(parameter);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

Opmerkingen

De grootte en Precision worden afgeleid van de waarde van de dbType parameter als ze niet expliciet zijn ingesteld in de size en precision parameters.

Zie ook

Van toepassing op

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);

public SqlParameter(string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);

new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)

Parameters

parameterName: String

De naam van de parameter die moet worden toegewezen.

dbType: SqlDbType

Een van de SqlDbType waarden.

size: Int32

De lengte van de parameter.

direction: ParameterDirection

Een van de ParameterDirection waarden.

precision: Byte

Het totale aantal cijfers links en rechts van het decimaalteken waarnaar Value wordt omgezet.

scale: Byte

Het totale aantal decimalen waarnaar Value wordt omgezet.

sourceColumn: String

De naam van de bronkolom (SourceColumn) als deze SqlParameter wordt gebruikt in een aanroep naar Update.

sourceVersion: DataRowVersion

Een van de DataRowVersion waarden.

sourceColumnNullMapping: Boolean

true als de bronkolom nullable is; false als dat niet zo is.

value: Object

Een Object die de waarde is van de SqlParameter.

xmlSchemaCollectionDatabase: String

De naam van de database waarin de schemaverzameling voor dit XML-exemplaar zich bevindt.

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

De naam van de schemaverzameling voor deze parameter.

Opmerkingen

De Size en Precision worden afgeleid van de waarde van de dbType parameter als ze niet expliciet zijn ingesteld in de size en precision parameters.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?