Aracılığıyla paylaş


OleDbParameter Sınıf

Tanım

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 IDataParameter
    interface IDbDataParameter
    interface ICloneable
[<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 ICloneable
    interface IDbDataParameter
    interface IDataParameter
Public NotInheritable Class OleDbParameter
Inherits DbParameter
Implements ICloneable
Public NotInheritable Class OleDbParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Devralma
Devralma
OleDbParameter
Ö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)

Şunlara uygulanır

Ayrıca bkz.