SqlParameter Oluşturucular

Başvuru

Tanım

Ad Alanı:: System.Data.SqlClient

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

SqlParameter sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

SqlParameter()	SqlParameter sınıfının yeni bir örneğini başlatır.
SqlParameter(String, SqlDbType)	Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, Object)	parametresinin SqlParameter adını ve değerini kullanan sınıfının yeni SqlParameterbir örneğini başlatır.
SqlParameter(String, SqlDbType, Int32)	parametre adını, ve boyutunu kullanan sınıfın SqlDbTypeyeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, String)	parametre adını, SqlDbType, boyutunu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Parametre adını, parametrenin türünü, parametresinin boyutunu, bir ParameterDirection, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütununu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfın yeni bir DataRowVersion örneğini SqlParameter başlatır.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Parametre adını, parametrenin türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniDataRowVersion, kaynak sütun eşlemesi için Boole değerini, değerini `SqlParameter`, bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır. bu XML örneğinin şema koleksiyonunun bulunduğu ilişkisel şemaya ve bu parametrenin şema koleksiyonunun adına sahip.

SqlParameter()

SqlParameter sınıfının yeni bir örneğini başlatır.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType)

Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türü.

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Açıklamalar

Veri türü ve uygunsa Boyut ve Precision parametresinin değerinden dbType çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, Object)

parametresinin SqlParameter adını ve değerini kullanan sınıfının yeni SqlParameterbir örneğini başlatır.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

value: Object

Object değerinin değeridirSqlParameter.

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Açıklamalar

parametresinde bir Object belirttiğinizdevalue, SqlDbType öğesinin Microsoft .NET Framework türünden Objectçıkarılır.

Tamsayı parametre değerlerini belirtmek için oluşturucunun bu aşırı yüklemesini SqlParameter kullanırken dikkatli olun. Bu aşırı yükleme türünde Objectbir value aldığından, aşağıdaki C# örneğinde gösterildiği gibi, değer sıfır olduğunda integral değerini bir Object türe dönüştürmeniz gerekir.

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

Bu dönüştürmeyi gerçekleştirmezseniz, derleyici oluşturucu aşırı yüklemesini çağırmaya SqlParameter(String, SqlDbType) çalıştığınızı varsayar.

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32)

parametre adını, ve boyutunu kullanan sınıfın SqlDbTypeyeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametre uzunluğu.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türü.

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Açıklamalar

Parametresinde açıkça ayarlanmadıysa Boyut parametresinin dbType değerinden size çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32, String)

parametre adını, SqlDbType, boyutunu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametre uzunluğu.

sourceColumn: String

Çağrısında Updatekullanılıyorsa SqlParameter kaynak sütunun adı (SourceColumn).

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türü.

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Açıklamalar

Parametresinde açıkça ayarlanmadıysa Boyut parametresinin dbType değerinden size çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

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

Parametre adını, parametrenin türünü, parametresinin boyutunu, bir ParameterDirection, parametresinin duyarlığı, parametrenin ölçeğini, kaynak sütununu, kullanılacak a'yı ve parametrenin değerini kullanan sınıfın yeni bir DataRowVersion örneğini SqlParameter başlatır.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametre uzunluğu.

direction: ParameterDirection

Değerlerden ParameterDirection biri.

isNullable: Boolean

true alanın değeri null olabilir; aksi takdirde , false.

precision: Byte

Çözülen ondalık ayırıcının Value solunda ve sağındaki toplam basamak sayısı.

scale: Byte

Çözümlenen Value ondalık basamakların toplam sayısı.

sourceColumn: String

Çağrısında Updatekullanılıyorsa SqlParameter kaynak sütunun adı (SourceColumn).

sourceVersion: DataRowVersion

Değerlerden DataRowVersion biri.

value: Object

Object değerinin değeridirSqlParameter.

Özel durumlar

ArgumentException

parametresinde dbType sağlanan değer geçersiz bir arka uç veri türü.

Örnekler

Aşağıdaki örnek, bir SqlParameter oluşturur ve bazı özelliklerini ayarlar.

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

Açıklamalar

Ve parametrelerinde açıkça ayarlanmadıysa, BoyutPrecision ve precision parametresinin dbType değerinden size çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

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

Parametre adını, parametrenin türünü, parametrenin yönünün uzunluğunu, duyarlığı, ölçeği, kaynak sütunun adını, değerlerden biriniDataRowVersion, kaynak sütun eşlemesi için Boole değerini, değerini SqlParameter, bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını kullanan sınıfın yeni bir örneğini SqlParameter başlatır. bu XML örneğinin şema koleksiyonunun bulunduğu ilişkisel şemaya ve bu parametrenin şema koleksiyonunun adına sahip.

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)

Parametreler

parameterName: String

Eşlenecek parametrenin adı.

dbType: SqlDbType

Değerlerden SqlDbType biri.

size: Int32

Parametre uzunluğu.

direction: ParameterDirection

Değerlerden ParameterDirection biri.

precision: Byte

Çözülen ondalık ayırıcının Value solunda ve sağındaki toplam basamak sayısı.

scale: Byte

Çözümlenen Value ondalık basamakların toplam sayısı.

sourceColumn: String

Çağrısında Updatekullanılıyorsa SqlParameter kaynak sütunun adı (SourceColumn).

sourceVersion: DataRowVersion

Değerlerden DataRowVersion biri.

sourceColumnNullMapping: Boolean

true kaynak sütun null atanabilirse; false değilse.

value: Object

Object değerinin değeridirSqlParameter.

xmlSchemaCollectionDatabase: String

Bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adı.

xmlSchemaCollectionOwningSchema: String

Bu XML örneğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema.

xmlSchemaCollectionName: String

Bu parametre için şema koleksiyonunun adı.

Açıklamalar

Size ve Precision parametrelerinde açıkça ayarlanmadıysa parametresinin dbType değerinden sizeprecision çıkarılır.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

SqlParameter Oluşturucular

Tanım

Aşırı Yüklemeler

SqlParameter()

Örnekler

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, Object)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SqlParameter(String, SqlDbType, Int32, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar