SqlParameter Konstruktorer

Definition

Namnområde:: System.Data.SqlClient

Sammansättning:: System.Data.SqlClient.dll

Sammansättning:: System.Data.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av SqlParameter klassen.

Överlagringar

Name	Description
SqlParameter()	Initierar en ny instans av SqlParameter klassen.
SqlParameter(String, SqlDbType)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet och datatypen.
SqlParameter(String, Object)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet och värdet för den nya SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, och storleken.
SqlParameter(String, SqlDbType, Int32, String)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, storleken och källkolumnnamnet.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, typen av parameter, parameterns storlek, en ParameterDirection, parameterns precision, parameterns skala, källkolumnen, en DataRowVersion att använda och värdet för parametern.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, parametertypen, längden på parametern riktningen, precisionen, skalan, namnet på källkolumnen, ett av DataRowVersion värdena, ett booleskt värde för källkolumnmappning, värdet `SqlParameter`för , namnet på databasen där schemasamlingen för den här XML-instansen finns. det ägande relationsschemat där schemasamlingen för den här XML-instansen finns och namnet på schemasamlingen för den här parametern.

SqlParameter()

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen.

public:
 SqlParameter();

public SqlParameter();

Public Sub New ()

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Se även

Gäller för

SqlParameter(String, SqlDbType)

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet och datatypen.

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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

dbType: SqlDbType

Ett av SqlDbType värdena.

Undantag

ArgumentException

Värdet som anges i parametern dbType är en ogiltig serverdelsdatatyp.

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

Datatypen och, om tillämpligt, Storlek och Precision härleds från värdet för parametern dbType .

Se även

Gäller för

SqlParameter(String, Object)

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet och värdet för den nya 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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

value: Object

En Object som är värdet för SqlParameter.

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

När du anger en Object i parametern value härleds SqlDbType från den Microsoft .NET typen av Object.

Var försiktig när du använder den här överbelastningen SqlParameter av konstruktorn för att ange heltalsparametervärden. Eftersom den här överlagringen tar en value av typen Objectmåste du konvertera integralvärdet till en Object typ när värdet är noll, vilket visas i följande C#-exempel.

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

Om du inte utför den här konverteringen förutsätter kompilatorn att du försöker anropa SqlParameter(String, SqlDbType) konstruktorns överlagring.

Se även

Gäller för

SqlParameter(String, SqlDbType, Int32)

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, och storleken.

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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

dbType: SqlDbType

Ett av SqlDbType värdena.

size: Int32

Längden på parametern.

Undantag

ArgumentException

Värdet som anges i parametern dbType är en ogiltig serverdelsdatatyp.

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

Storleken härleds från värdet för parametern dbType om den inte uttryckligen anges i parameternsize.

Se även

Gäller för

SqlParameter(String, SqlDbType, Int32, String)

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, storleken och källkolumnnamnet.

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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

dbType: SqlDbType

Ett av SqlDbType värdena.

size: Int32

Längden på parametern.

sourceColumn: String

Namnet på källkolumnen (SourceColumn) om detta SqlParameter används i ett anrop till Update.

Undantag

ArgumentException

Värdet som anges i parametern dbType är en ogiltig serverdelsdatatyp.

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

Storleken härleds från värdet för parametern dbType om den inte uttryckligen anges i parameternsize.

Se även

Gäller för

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

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet, typen av parameter, parameterns storlek, en ParameterDirection, parameterns precision, parameterns skala, källkolumnen, en DataRowVersion att använda och värdet för parametern.

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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

dbType: SqlDbType

Ett av SqlDbType värdena.

size: Int32

Längden på parametern.

direction: ParameterDirection

Ett av ParameterDirection värdena.

isNullable: Boolean

trueom värdet för fältet kan vara null; annars . false

precision: Byte

Det totala antalet siffror till vänster och höger om decimaltecknet som Value matchas.

scale: Byte

Det totala antalet decimaler som Value har lösts.

sourceColumn: String

Namnet på källkolumnen (SourceColumn) om detta SqlParameter används i ett anrop till Update.

sourceVersion: DataRowVersion

Ett av DataRowVersion värdena.

value: Object

En Object som är värdet för SqlParameter.

Undantag

ArgumentException

Värdet som anges i parametern dbType är en ogiltig serverdelsdatatyp.

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

Storlek och Precision härleds från värdet för parametern dbType om de inte uttryckligen anges i parametrarna size ochprecision.

Se även

Gäller för

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

Källa:: System.Data.SqlClient.notsupported.cs

Initierar en ny instans av SqlParameter klassen som använder parameternamnet, parametertypen, längden på parametern riktningen, precisionen, skalan, namnet på källkolumnen, ett av DataRowVersion värdena, ett booleskt värde för källkolumnmappning, värdet SqlParameterför , namnet på databasen där schemasamlingen för den här XML-instansen finns. det ägande relationsschemat där schemasamlingen för den här XML-instansen finns och namnet på schemasamlingen för den här parametern.

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)

Parametrar

parameterName: String

Namnet på parametern som ska mappas.

dbType: SqlDbType

Ett av SqlDbType värdena.

size: Int32

Längden på parametern.

direction: ParameterDirection

Ett av ParameterDirection värdena.

precision: Byte

Det totala antalet siffror till vänster och höger om decimaltecknet som Value matchas.

scale: Byte

Det totala antalet decimaler som Value har lösts.

sourceColumn: String

Namnet på källkolumnen (SourceColumn) om detta SqlParameter används i ett anrop till Update.

sourceVersion: DataRowVersion

Ett av DataRowVersion värdena.

sourceColumnNullMapping: Boolean

true om källkolumnen är nullbar; false om det inte är det.

value: Object

En Object som är värdet för SqlParameter.

xmlSchemaCollectionDatabase: String

Namnet på databasen där schemasamlingen för den här XML-instansen finns.

xmlSchemaCollectionOwningSchema: String

Det ägande relationsschemat där schemasamlingen för den här XML-instansen finns.

xmlSchemaCollectionName: String

Namnet på schemasamlingen för den här parametern.

Kommentarer

Och Size Precision härleds från värdet för parametern dbType om de inte uttryckligen anges i parametrarna size och precision .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?