SqlParameter Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Zestawy:: netstandard.dll, System.Data.SqlClient.dll

Pakiet:: System.Data.SqlClient v4.8.6

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy SqlParameter.

Przeciążenia

SqlParameter()	Inicjuje nowe wystąpienie klasy SqlParameter.
SqlParameter(String, SqlDbType)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.
SqlParameter(String, Object)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i wartości nowego SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbTypei rozmiaru.
SqlParameter(String, SqlDbType, Int32, String)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, rozmiaru parametru, ParameterDirectionprecyzji parametru, skali parametru, kolumny źródłowej, DataRowVersion wartości do użycia i wartości parametru.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, długości parametru kierunku, dokładności, skali, nazwy kolumny źródłowej, jednej z DataRowVersion wartości, wartości logicznej mapowania kolumny źródłowej, wartości , nazwy `SqlParameter`bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, jest właścicielem schematu relacyjnego, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru.

SqlParameter()

Inicjuje nowe wystąpienie klasy SqlParameter.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.

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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

dbType: SqlDbType

SqlDbType Jedna z wartości.

Wyjątki

ArgumentException

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Typ danych i, jeśli to konieczne, Size i Precision są wnioskowane z wartości parametru dbType .

Zobacz też

Dotyczy

SqlParameter(String, Object)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i wartości nowego 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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

value: Object

Wartość Object , która jest wartością SqlParameter.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Po określeniu Object elementu w parametrze valueSqlDbType element jest wywnioskowany z typu Microsoft .NET Framework typu Object.

Należy zachować ostrożność podczas używania tego przeciążenia konstruktora SqlParameter do określania wartości parametrów całkowitych. Ponieważ to przeciążenie przyjmuje value typ Object, należy przekonwertować wartość całkowitą na Object typ, gdy wartość jest równa zero, jak pokazano w poniższym przykładzie języka C#.

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

Jeśli nie wykonasz tej konwersji, kompilator zakłada, że próbujesz wywołać przeciążenie konstruktora SqlParameter(String, SqlDbType) .

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType, Int32)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbTypei rozmiaru.

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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

dbType: SqlDbType

SqlDbType Jedna z wartości.

size: Int32

Długość parametru.

Wyjątki

ArgumentException

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Parametr Size jest wywnioskowany z wartości parametru dbType , jeśli nie jest jawnie ustawiony w parametrze size .

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType, Int32, String)

Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej.

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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

dbType: SqlDbType

SqlDbType Jedna z wartości.

size: Int32

Długość parametru.

sourceColumn: String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update.

Wyjątki

ArgumentException

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Parametr Size jest wywnioskowany z wartości parametru dbType , jeśli nie jest jawnie ustawiony w parametrze size .

Zobacz też

Dotyczy

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, rozmiaru parametru, ParameterDirectionprecyzji parametru, skali parametru, kolumny źródłowej, DataRowVersion wartości do użycia i wartości parametru.

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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

dbType: SqlDbType

SqlDbType Jedna z wartości.

size: Int32

Długość parametru.

direction: ParameterDirection

ParameterDirection Jedna z wartości.

isNullable: Boolean

true jeśli wartość pola może mieć wartość null; w przeciwnym razie , false.

precision: Byte

Całkowita liczba cyfr po lewej i prawej stronie punktu dziesiętnego, do którego Value jest rozpoznawana.

scale: Byte

Całkowita liczba miejsc dziesiętnych, do których Value jest rozpoznawana.

sourceColumn: String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update.

sourceVersion: DataRowVersion

DataRowVersion Jedna z wartości.

value: Object

Wartość Object , która jest wartością SqlParameter.

Wyjątki

ArgumentException

Wartość podana w parametrze dbType jest nieprawidłowym typem danych zaplecza.

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Parametr Size i Precision są wnioskowane z wartości parametru dbType , jeśli nie są jawnie ustawione w parametrach size i precision .

Zobacz też

Dotyczy

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

Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, długości parametru kierunku, dokładności, skali, nazwy kolumny źródłowej, jednej z DataRowVersion wartości, wartości logicznej mapowania kolumny źródłowej, wartości SqlParameternazwy bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru.

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)

Parametry

parameterName: String

Nazwa parametru do mapowania.

dbType: SqlDbType

SqlDbType Jedna z wartości.

size: Int32

Długość parametru.

direction: ParameterDirection

ParameterDirection Jedna z wartości.

precision: Byte

Całkowita liczba cyfr po lewej i prawej stronie punktu dziesiętnego, do którego Value jest rozpoznawana.

scale: Byte

Całkowita liczba miejsc dziesiętnych, do których Value jest rozpoznawana.

sourceColumn: String

Nazwa kolumny źródłowej (SourceColumn), jeśli jest używana SqlParameter w wywołaniu metody Update.

sourceVersion: DataRowVersion

DataRowVersion Jedna z wartości.

sourceColumnNullMapping: Boolean

true jeśli kolumna źródłowa ma wartość null; false jeśli tak nie jest.

value: Object

Wartość Object , która jest wartością SqlParameter.

xmlSchemaCollectionDatabase: String

Nazwa bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML.

xmlSchemaCollectionOwningSchema: String

Schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML.

xmlSchemaCollectionName: String

Nazwa kolekcji schematów dla tego parametru.

Uwagi

Parametry Size i Precision są wnioskowane z wartości parametru dbType , jeśli nie są jawnie ustawione w parametrach size i precision .

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

SqlParameter Konstruktory

Definicja

Przeciążenia

SqlParameter()

Przykłady

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

SqlParameter(String, Object)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

SqlParameter(String, SqlDbType, Int32, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby