OleDbParameter 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 OleDbCommand ve isteğe bağlı olarak bir DataSet sütuna eşlemesini temsil eder. Bu sınıf devralınamaz.
public ref class OleDbParameter sealed : System::Data::Common::DbParameter, ICloneable
public ref class OleDbParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))]
public sealed class OleDbParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameterConverter))]
public sealed class OleDbParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))>]
type OleDbParameter = class
inherit DbParameter
interface ICloneable
interface IDbDataParameter
interface IDataParameter
[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameterConverter))>]
type OleDbParameter = class
inherit MarshalByRefObject
interface IDbDataParameter
interface IDataParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))>]
type OleDbParameter = class
inherit DbParameter
interface IDataParameter
interface IDbDataParameter
interface ICloneable
Public NotInheritable Class OleDbParameter
Inherits DbParameter
Implements ICloneable
Public NotInheritable Class OleDbParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
- Devralma
- Devralma
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki örnek içinde OleDbDataAdapterkoleksiyonu aracılığıyla OleDbParameterCollection birden çok örneği OleDbParameter oluşturur. Bu parametreler, veri kaynağından veri seçmek ve verileri öğesine DataSetyerleştirmek için kullanılır. Bu örnekte, uygun şema, komutlar ve bağlantı kullanılarak bir DataSet ve'nin OleDbDataAdapter önceden oluşturulduğu varsayılır.
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OleDbConnection connection =
new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter =
new OleDbDataAdapter(queryString, connection);
// Set the parameters.
adapter.SelectCommand.Parameters.Add(
"@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
adapter.SelectCommand.Parameters.Add(
"@SerialNum", OleDbType.Integer).Value = 239;
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter(queryString, connection)
' Set the parameters.
adapter.SelectCommand.Parameters.Add( _
"@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
adapter.SelectCommand.Parameters.Add( _
"@SerialNum", OleDbType.Integer).Value = 239
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
Açıklamalar
OLE DB.NET Framework Veri Sağlayıcısı, adlandırılmış parametreler yerine soru işareti (?) ile işaretlenmiş konumsal parametreler kullanır.
Oracle için Microsoft OLE DB Sağlayıcısı (MSDAORA) ve OLE DB.NET Framework Veri Sağlayıcısı'nı kullanarak oracle veritabanını sorgularken, sabit uzunluktaki alanlardaki değerleri sorgulamak için yan tümcesini LIKE
kullanmak beklenen tüm eşleşmeleri döndürmeyebilir. Bunun nedeni, Oracle bir LIKE
yan tümcedeki sabit uzunluklu alanların değerlerini eşlediğinde, sonundaki boşluklar da dahil olmak üzere dizenin tüm uzunluğuyla eşleşmesidir. Örneğin, Oracle veritabanındaki bir tabloda olarak char(3)
tanımlanan "Alan1" adlı bir alan varsa ve bu tablonun satırına "a" değerini girerseniz, aşağıdaki kod satırı döndürmez.
Dim queryString As String = "SELECT * FROM Table1 WHERE Field1 LIKE ?"
Dim command As OleDbCommand = New OleDbCommand(queryString, connection)
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a"
Dim reader As OleDbDataReader = command.ExecuteReader()
string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE ?";
OleDbCommand command = new OleDbCommand(queryString, connection);
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a";
OleDbDataReader reader = command.ExecuteReader();
Bunun nedeni Oracle'ın sütun değerini "a" olarak depolaması (sonunda boşluklar olan "a"yı sabit alan uzunluğuna 3) depolaması ve sabit uzunluklu alanların karşılaştırması durumunda Oracle'ın "a" parametre değeri için bir LIKE
eşleşme olarak davranmamasıdır.
Bu sorunu çözmek için parametre değerine bir yüzde ("%") joker karakteri ekleyin ()"a%"
veya bunun yerine bir SQL =
karşılaştırması kullanın.
Oluşturucular
OleDbParameter() |
OleDbParameter sınıfının yeni bir örneğini başlatır. |
OleDbParameter(String, Object) |
parametre adını ve yeni değerini kullanan sınıfının yeni OleDbParameterbir örneğini OleDbParameter başlatır. |
OleDbParameter(String, OleDbType) |
Parametre adını ve veri türünü kullanan sınıfın yeni bir örneğini OleDbParameter başlatır. |
OleDbParameter(String, OleDbType, Int32) |
Parametre adını, veri türünü ve uzunluğu kullanan sınıfın yeni bir örneğini OleDbParameter başlatır. |
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Parametre adı, veri türü, uzunluk, kaynak sütun adı, parametre yönü, sayısal duyarlık ve diğer özellikleri kullanan sınıfın yeni bir örneğini OleDbParameter başlatır. |
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object) |
Parametre adı, veri türü, uzunluk, kaynak sütun adı, parametre yönü, sayısal duyarlık ve diğer özellikleri kullanan sınıfın yeni bir örneğini OleDbParameter başlatır. |
OleDbParameter(String, OleDbType, Int32, String) |
Parametre adını, veri türünü, uzunluğu ve kaynak sütun adını kullanan sınıfın yeni bir örneğini OleDbParameter başlatır. |
Özellikler
DbType |
parametresini DbType alır veya ayarlar. |
Direction |
Parametrenin yalnızca giriş, yalnızca çıkış, çift yönlü veya saklı yordam dönüş değeri parametresi olup olmadığını gösteren bir değeri alır veya ayarlar. |
IsNullable |
Parametresinin null değerleri kabul edip etmediğini belirten bir değer alır veya ayarlar. |
OleDbType |
parametresini OleDbType alır veya ayarlar. |
ParameterName |
öğesinin adını OleDbParameteralı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 DataSetValueadını alır veya ayarlar. |
SourceColumnNullMapping |
Kaynak sütunun null atanabilir olup olmadığını gösteren bir değer alır veya ayarlar. Bu, boş değer atanabilir sütunlar için Update deyimlerinin doğru şekilde oluşturulmasını sağlar DbCommandBuilder . |
SourceVersion |
yüklerken Valuekullanılacak öğesini DataRowVersion alır veya ayarlar. |
Value |
parametresinin değerini alır veya ayarlar. |
Yöntemler
CreateObjRef(Type) |
Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject) |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetLifetimeService() |
Geçersiz.
Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
InitializeLifetimeService() |
Geçersiz.
Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
ResetDbType() |
Bu OleDbParameterile ilişkili türü sıfırlar. |
ResetOleDbType() |
Bu OleDbParameterile 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(). . |
IDbDataParameter.Precision |
Sayısal parametrelerin duyarlığı gösterir. (Devralındığı yer: DbParameter) |
IDbDataParameter.Scale |
Bu üyenin açıklaması için bkz Scale. . (Devralındığı yer: DbParameter) |