This documentation is archived and is not being maintained.

SqlParameter Constructor (String, SqlDbType, Int32)

Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, and the size.

Namespace:  System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)

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

Parameters

parameterName
Type: System.String
The name of the parameter to map.
dbType
Type: System.Data.SqlDbType
One of the SqlDbType values.
size
Type: System.Int32
The length of the parameter.

ExceptionCondition
ArgumentException

The value supplied in the dbType parameter is an invalid back-end data type.

The Size is inferred from the value of the dbType parameter if it is not explicitly set in the size parameter.

The following example creates a SqlParameter and sets some of its properties.


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


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: