OracleConnectionStringBuilder Sınıf

Tanım

Ad Alanı:

System.Data.OracleClient

Bütünleştirilmiş Kod:

System.Data.OracleClient.dll

Dikkat

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

sınıfı tarafından OracleConnection kullanılan bağlantı dizelerinin içeriğini oluşturmak ve yönetmek için basit bir yol sağlar.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Devralma

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Öznitelikler

TypeConverterAttribute ObsoleteAttribute

Örnekler

Aşağıdaki konsol uygulaması bir Oracle veritabanı için bağlantı dizeleri oluşturur. Kod, bağlantı dizesi oluşturmak için bir OracleConnectionStringBuilder sınıf kullanır ve ardından örneğin özelliğini OracleConnectionStringBuilder bağlantı sınıfının oluşturucusununa geçirirConnectionString. Örnek ayrıca mevcut bir bağlantı dizesi ayrıştırarak bağlantı dizesi içeriğini düzenlemenin çeşitli yollarını gösterir.

Not

Bu örnek, bağlantı dizeleriyle nasıl OracleConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

Açıklamalar

Bu tür kullanım dışıdır ve .NET Framework gelecekteki bir sürümünde kaldırılacaktır. Daha fazla bilgi için bkz. Oracle ve ADO.NET.

bağlantı dizesi oluşturucuları, geliştiricilerin program aracılığıyla el dizimsel olarak doğru bağlantı dizeleri oluşturmasına ve sınıfın özelliklerini ve yöntemlerini kullanarak mevcut bağlantı dizelerini ayrıştırıp yeniden oluşturmasına olanak sağlar. bağlantı dizesi oluşturucusu, Oracle tarafından izin verilen bilinen anahtar/değer çiftlerine karşılık gelen kesin olarak belirlenmiş özellikler sağlar. OracleConnectionStringBuilder sınıfı, ICustomTypeDescriptor arabirimini uygular. Bu, sınıfın tasarım zamanında Visual Studio .NET tasarımcılarıyla çalıştığı anlamına gelir. Geliştiriciler Visual Studio .NET içinde kesin olarak yazılan DataSet'ler ve kesin olarak yazılan bağlantılar oluşturmak için tasarımcıyı kullandığında, kesin olarak yazılan bağlantı dizesi oluşturucu sınıfı türüyle ilişkili özellikleri görüntüler ve ayrıca bilinen anahtarlar için ortak değerleri eşleyebilecek dönüştürücülere sahip olur.

Uygulamaların bir parçası olarak bağlantı dizeleri oluşturması gereken geliştiriciler, bağlantı dizelerini oluşturmak ve değiştirmek için sınıfını kullanabilir OracleConnectionStringBuilder . sınıfı, OracleConnectionStringBuilder bir uygulama yapılandırma dosyasında depolanan bağlantı dizelerini yönetmeyi de kolaylaştırır.

geçerli OracleConnectionStringBuilder anahtar/değer çiftleri için denetimler gerçekleştirir. Bu nedenle, bu sınıf geçersiz bağlantı dizeleri oluşturmak için kullanılamaz. Geçersiz çiftler eklemeye çalışmak bir özel durum oluşturur. OracleConnectionStringBuilder sınıfı sabit bir eş anlamlılar koleksiyonu tutar ve gerektiğinde eş anlamlıdan ilgili iyi bilinen anahtar adına dönüştürmek için gerekli çeviriyi gerçekleştirebilir. Örneğin, bir değeri almak için özelliğini kullandığınızda Item[] , ihtiyacınız olan anahtar için herhangi bir eş anlamlı içeren bir dize belirtebilirsiniz. Item[] Kabul edilebilir eş anlamlıların tam listesi için özelliğine bakın.

Tanıtıcılar OracleConnectionStringBuilder kötü amaçlı girişler eklemeye çalışır. Örneğin, aşağıdaki kodda varsayılan Item[] özellik (C# dilinde dizin oluşturucu) kullanıldığında iç içe anahtar/değer çiftinden doğru bir şekilde kaçılır.

Dim builder As New System.Data. _  
    OracleClient.OracleConnectionStringBuilder  
builder("Data Source") = "OracleDemo"  
builder("Integrated Security") = True  
builder("User ID") = "Mary;NewValue=Bad"  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)  

System.Data.OracleClient.OracleConnectionStringBuilder builder =  
   new System.Data.OracleClient.OracleConnectionStringBuilder();  
builder["Data Source"] = "OracleDemo";  
builder["integrated Security"] = true;  
builder["User ID"] = "Mary;NewValue=Bad";  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);  

Sonuç, Kullanıcı Kimliği değerini tırnak içine alarak geçersiz değeri güvenli bir şekilde işleyen aşağıdaki bağlantı dizesi olur:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"  

Oluşturucular

OracleConnectionStringBuilder()	Geçersiz. OracleConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
OracleConnectionStringBuilder(String)	Geçersiz. OracleConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgilerine ilişkin verileri sağlar.

Özellikler

BrowsableConnectionString	Geçersiz. Özelliğin Visual Studio tasarımcılarında görünür olup olmadığını ConnectionString gösteren bir değer alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
ConnectionString	Geçersiz. ile DbConnectionStringBuilderilişkili bağlantı dizesi alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
Count	Geçersiz. özelliği içinde ConnectionString yer alan geçerli anahtar sayısını alır. (Devralındığı yer: DbConnectionStringBuilder)
DataSource	Geçersiz. Bağlanacak Oracle veri kaynağının adını alır veya ayarlar.
Enlist	Geçersiz. Havuz oluşturucunun bağlantıyı oluşturma iş parçacığının geçerli işlem bağlamında otomatik olarak listeleyip listelemediğini belirten bir değer alır veya ayarlar.
IntegratedSecurity	Geçersiz. Bağlantıda "Kullanıcı Kimliği" ve "Parola" belirtilip belirtilmediğinde (ne zaman false) veya geçerli Windows hesabı kimlik bilgilerinin kimlik doğrulaması için kullanılıp kullanılmadığını (when true) belirten bir değer alır veya ayarlar.
IsFixedSize	Geçersiz. sabit bir boyuta sahip olup olmadığını OracleConnectionStringBuilder gösteren bir değer alır.
IsReadOnly	Geçersiz. öğesinin salt okunur olup olmadığını DbConnectionStringBuilder gösteren bir değer alır. (Devralındığı yer: DbConnectionStringBuilder)
Item[String]	Geçersiz. Belirtilen anahtarla ilişkili değeri alır veya ayarlar. C# dilinde bu özellik dizin oluşturucudur.
Keys	Geçersiz. içindeki OracleConnectionStringBuilderanahtarları içeren bir ICollection alır.
LoadBalanceTimeout	Geçersiz. Bağlantının kaldırılmadan önce bağlantı havuzunda yaşaması için saniye cinsinden en düşük süreyi alır veya ayarlar.
MaxPoolSize	Geçersiz. Bu özel bağlantı dizesi için bağlantı havuzunda izin verilen en fazla bağlantı sayısını alır veya ayarlar.
MinPoolSize	Geçersiz. Bu özel bağlantı dizesi için bağlantı havuzunda izin verilen en az bağlantı sayısını alır veya ayarlar.
OmitOracleConnectionName	Geçersiz. Oracle'ın önceki sürümlerinde (8.1.7.4.1 öncesi) işlem geri alma işlemlerini etkinleştiren bayrağı alır veya ayarlar.
Password	Geçersiz. Oracle hesabının parolasını alır veya ayarlar.
PersistSecurityInfo	Geçersiz. Bağlantı açıksa veya açık durumdaysa, parola gibi güvenlik açısından hassas bilgilerin bağlantının bir parçası olarak döndürülmediğini belirten bir Boole değeri alır veya ayarlar.
Pooling	Geçersiz. Bağlantının havuza alınıp alınmayacağını veya her bağlantı istenildiğinde her bağlantının açıkça açılıp açılmayacağını belirten bir Boole değeri alır veya ayarlar.
Unicode	Geçersiz. İstemcinin sonraki Oracle istemcilerinde kullanılabilen Unicode işlevselliğini desteklediğini veya Unicode'a duyarlı olmadığını belirten bir Boole değeri alır veya ayarlar.
UserID	Geçersiz. Oracle'a bağlanırken kullanılacak kullanıcı kimliğini alır veya ayarlar.
Values	Geçersiz. içindeki OracleConnectionStringBuilderdeğerleri içeren bir ICollection alır.

Yöntemler

Add(String, Object)	Geçersiz. öğesine belirtilen anahtara ve değere DbConnectionStringBuildersahip bir girdi ekler. (Devralındığı yer: DbConnectionStringBuilder)
Clear()	Geçersiz. Örneğin içeriğini OracleConnectionStringBuilder temizler.
ClearPropertyDescriptors()	Geçersiz. İlişkili DbConnectionStringBuilderüzerindeki nesne koleksiyonunu PropertyDescriptor temizler. (Devralındığı yer: DbConnectionStringBuilder)
ContainsKey(String)	Geçersiz. öğesinin OracleConnectionStringBuilder belirli bir anahtar içerip içermediğini belirler.
Equals(Object)	Geçersiz. Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
EquivalentTo(DbConnectionStringBuilder)	Geçersiz. Bu DbConnectionStringBuilder nesnedeki bağlantı bilgilerini sağlanan nesnedeki bağlantı bilgileriyle karşılaştırır. (Devralındığı yer: DbConnectionStringBuilder)
GetHashCode()	Geçersiz. Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperties(Hashtable)	Geçersiz. Sağlanan Hashtable bir öğesini bu DbConnectionStringBuilderöğesinin tüm özellikleriyle ilgili bilgilerle doldurur. (Devralındığı yer: DbConnectionStringBuilder)
GetType()	Geçersiz. Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçersiz. Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove(String)	Geçersiz. Belirtilen anahtara sahip girişi örnekten OracleConnectionStringBuilder kaldırır.
ShouldSerialize(String)	Geçersiz. Belirtilen anahtarın bu OracleConnectionStringBuilder örnekte var olup olmadığını gösterir.
ToString()	Geçersiz. Bu DbConnectionStringBuilderile ilişkili bağlantı dizesi döndürür. (Devralındığı yer: DbConnectionStringBuilder)
TryGetValue(String, Object)	Geçersiz. Bu OracleConnectionStringBuilderanahtarından sağlanan anahtara karşılık gelen bir değeri alır.

Belirtik Arabirim Kullanımları

ICollection.CopyTo(Array, Int32)	Geçersiz. öğesinin ICollection öğelerini belirli Array bir dizinden başlayarak öğesine Arraykopyalar. (Devralındığı yer: DbConnectionStringBuilder)
ICollection.IsSynchronized	Geçersiz. erişimin ICollection eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli). (Devralındığı yer: DbConnectionStringBuilder)
ICollection.SyncRoot	Geçersiz. erişimi ICollectioneşitlemek için kullanılabilecek bir nesnesi alır. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Geçersiz. Bir bileşenin bu örneği için özel özniteliklerden oluşan bir koleksiyon döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Geçersiz. Bir bileşenin bu örneğinin sınıf adını döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Geçersiz. Bir bileşenin bu örneğinin adını döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Geçersiz. Bir bileşenin bu örneği için tür dönüştürücüsü döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Geçersiz. Bir bileşenin bu örneği için varsayılan olayı döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Geçersiz. Bir bileşenin bu örneği için varsayılan özelliği döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Geçersiz. Bir bileşenin bu örneği için belirtilen türde bir düzenleyici döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Geçersiz. Bir bileşenin bu örneği için olayları döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Geçersiz. Belirtilen öznitelik dizisini filtre olarak kullanarak bir bileşenin bu örneği için olayları döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Geçersiz. Bir bileşenin bu örneği için özellikleri döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Geçersiz. Öznitelik dizisini filtre olarak kullanarak bir bileşenin bu örneğinin özelliklerini döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Geçersiz. Belirtilen özellik tanımlayıcısı tarafından açıklanan özelliği içeren bir nesne döndürür. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Geçersiz. Sağlanan anahtar ve değere sahip bir öğeyi nesnesine IDictionary ekler. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Contains(Object)	Geçersiz. Nesnenin belirtilen anahtara IDictionary sahip bir öğe içerip içermediğini belirler. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Geçersiz. Nesne için IDictionary bir IDictionaryEnumerator nesne döndürür. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Item[Object]	Geçersiz. Belirtilen anahtarla öğesini alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Remove(Object)	Geçersiz. Belirtilen anahtara sahip öğeyi nesneden IDictionary kaldırır. (Devralındığı yer: DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Geçersiz. Bir toplulukta tekrarlanan bir numaralandırıcı döndürür. (Devralındığı yer: DbConnectionStringBuilder)

Uzantı Metotları

Cast<TResult>(IEnumerable)	Geçersiz. öğesinin IEnumerable öğelerini belirtilen türe atar.
OfType<TResult>(IEnumerable)	Geçersiz. Öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Geçersiz. Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	Geçersiz. bir IEnumerable öğesini öğesine IQueryabledönüştürür.

Ayrıca bkz.

• Bağlantı Dizeleri Oluşturma