SqlParameter Sınıf
Tanım
Ö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.
bir parametresini SqlCommand ve isteğe bağlı olarak sütunlara eşlemesini DataSet temsil eder. Bu sınıf devralınamaz. Parametreler hakkında daha fazla bilgi için bkz . Parametreleri yapılandırma.
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
inherit DbParameter
interface IDbDataParameter
interface IDataParameter
interface ICloneable
type SqlParameter = class
inherit DbParameter
interface IDataParameter
interface IDbDataParameter
interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
- Devralma
-
SqlParameter
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki örnek içinde SqlDataAdapterkoleksiyonu aracılığıyla SqlParameterCollection birden çok örneği SqlParameter oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri içine DataSetkoymak için kullanılır. Bu örnekte, uygun şema, komutlar ve bağlantı kullanılarak bir DataSet ve'nin SqlDataAdapter önceden oluşturulduğu varsayılır. Parametreleri kullanma hakkında daha fazla bilgi ve ek örnekler için bkz. ADO.NET Verileri Alma ve Değiştirme ve Parametreleri yapılandırma.
using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;
public class Form1 : Form
{
protected DataSet categoriesDataSet;
protected DataGrid dataGrid1;
protected SqlDataAdapter categoriesAdapter;
public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...
categoriesAdapter.SelectCommand.Parameters.Add(
"@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
categoriesAdapter.SelectCommand.Parameters.Add(
"@SerialNum", SqlDbType.Int).Value = 239;
categoriesAdapter.Fill(categoriesDataSet);
}
}
Açıklamalar
Parametre adları büyük/küçük harfe duyarlı değildir.
Not
Sıralı olarak da adlandırılan adsız parametreler, SQL Server için .NET Framework Veri Sağlayıcısı tarafından desteklenmez.
Parametrelerin nasıl kullanılacağını gösteren ek örnek kodun yanı sıra daha fazla bilgi için bkz . Komutlar ve Parametreler.
Oluşturucular
SqlParameter() |
SqlParameter sınıfının yeni bir örneğini 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) |
Parametre adını ve veri türünü kullanan sınıfının yeni bir örneğini SqlParameter 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, 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ütunu, kullanılacak a değerini ve parametresinin 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(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. |
Özellikler
CompareInfo |
Bu parametre için dize karşılaştırmalarının nasıl gerçekleştirilmesi gerektiğini tanımlayan nesneyi alır veya ayarlar CompareInfo . |
DbType |
parametresini SqlDbType alır veya ayarlar. |
Direction |
Parametrenin yalnızca giriş, yalnızca çıkış, çift yönlü veya saklı yordam dönüş değeri parametresi olduğunu belirten bir değer alır veya ayarlar. |
ForceColumnEncryption |
Always Encrypted kullanırken parametrenin şifrelenmesini zorlar. SQL Server, parametrenin şifrelenmesinin gerekmediğini sürücüye bildirirse, parametresini kullanan sorgu başarısız olur. Bu özellik, güvenliği aşılmış bir SQL Server istemciye yanlış şifreleme meta verileri sağlayarak verilerin açığa çıkmasına neden olabilecek güvenlik saldırılarına karşı ek koruma sağlar. |
IsNullable |
Parametresinin null değerleri kabul edip etmediğini belirten bir değer alır veya ayarlar. IsNullable parametresinin değerini doğrulamak için kullanılmaz ve komut yürütülürken null değer gönderilmesini veya alınmasını engellemez. |
LocaleId |
Belirli bir bölge için kuralları ve dili belirleyen yerel ayar tanımlayıcısını alır veya ayarlar. |
Offset |
Özelliğin uzaklığını Value alır veya ayarlar. |
ParameterName |
öğesinin adını SqlParameteralır veya ayarlar. |
Precision |
Özelliği temsil Value etmek için kullanılan en fazla basamak sayısını alır veya ayarlar. |
Scale |
Çözülen ondalık basamak Value sayısını alır veya ayarlar. |
Size |
Sütundaki verilerin bayt cinsinden en büyük boyutunu alır veya ayarlar. |
SourceColumn |
ile eşlenen ve yükleme veya döndürme için kullanılan kaynak sütunun DataSet adını alır veya ayarlar Value |
SourceColumnNullMapping |
Kaynak sütunun null atanabilir olup olmadığını gösteren bir değer ayarlar veya alır. Bu, boş değer atanabilir sütunlar için Update deyimlerinin doğru şekilde oluşturulmasını sağlar SqlCommandBuilder . |
SourceVersion |
Yüklerken kullanılacak olan ' DataRowVersion ı alır veya ayarlar Value |
SqlDbType |
parametresini SqlDbType alır veya ayarlar. |
SqlValue |
Parametrenin değerini SQL türü olarak alır veya ayarlar. |
TypeName |
Tablo değerli bir parametrenin tür adını alır veya ayarlar. |
UdtTypeName |
Parametre olarak kullanıcı tanımlı bir türü temsil eden bir alır veya ayarlar |
Value |
parametresinin değerini alır veya ayarlar. |
XmlSchemaCollectionDatabase |
Bu XML örneğinin şema koleksiyonunun bulunduğu veritabanının adını alır. |
XmlSchemaCollectionName |
Bu XML örneği için şema koleksiyonunun adını alır. |
XmlSchemaCollectionOwningSchema |
Bu XML örneğinin şema koleksiyonunun bulunduğu sahip olan ilişkisel şema. |
Yöntemler
ResetDbType() |
Bu SqlParameterile ilişkili türü sıfırlar. |
ResetSqlDbType() |
Bu SqlParameterile ilişkili türü sıfırlar. |
ToString() |
öğesini içeren ParameterNamebir dize alır. |
Belirtik Arabirim Kullanımları
ICloneable.Clone() |
Bu üyenin açıklaması için bkz Clone(). . |