SqlParameter Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v1.0.19269.1

Pakiet:: Microsoft.Data.SqlClient v1.1.4

Pakiet:: Microsoft.Data.SqlClient v2.0.1

Pakiet:: Microsoft.Data.SqlClient v2.1.4

Pakiet:: Microsoft.Data.SqlClient v3.0.1

Pakiet:: Microsoft.Data.SqlClient v3.1.0

Pakiet:: Microsoft.Data.SqlClient v4.0.1

Pakiet:: Microsoft.Data.SqlClient v4.1.0

Pakiet:: Microsoft.Data.SqlClient v5.0.0

Pakiet:: Microsoft.Data.SqlClient v5.1.0

Pakiet:: Microsoft.Data.SqlClient v5.2.0

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.

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Uwagi

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

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 Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

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) .

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Uwagi

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.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(DataSet)>.

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Uwagi

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

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.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(DataSet).

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

Uwagi

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

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 , nazwy SqlParameterbazy 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.

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.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(DataSet)>.

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 .

Dotyczy

Udostępnij za pośrednictwem

SqlParameter Konstruktory

Definicja

Przeciążenia

SqlParameter()

Przykłady

Dotyczy

SqlParameter(String, SqlDbType)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

SqlParameter(String, Object)

Parametry

Przykłady

Uwagi

Dotyczy

SqlParameter(String, SqlDbType, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

SqlParameter(String, SqlDbType, Int32, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

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

Parametry

Uwagi

Dotyczy

Dodatkowe zasoby