OleDbConnectionStringBuilder Oluşturucular
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.
OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
Aşırı Yüklemeler
OleDbConnectionStringBuilder() |
OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır. |
OleDbConnectionStringBuilder(String) |
OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgileri için verileri sağlar. |
OleDbConnectionStringBuilder()
OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
public:
OleDbConnectionStringBuilder();
public OleDbConnectionStringBuilder ();
Public Sub New ()
Ayrıca bkz.
Şunlara uygulanır
OleDbConnectionStringBuilder(String)
OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgileri için verileri sağlar.
public:
OleDbConnectionStringBuilder(System::String ^ connectionString);
public OleDbConnectionStringBuilder (string? connectionString);
public OleDbConnectionStringBuilder (string connectionString);
new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder
Public Sub New (connectionString As String)
Parametreler
- connectionString
- String
Nesnenin iç bağlantı bilgilerinin temeli. Anahtar/değer çiftlerine ayrıştırılır.
Özel durumlar
bağlantı dizesi yanlış biçimlendirildi (anahtar/değer çiftinde gerekli "=" eksik olabilir).
Örnekler
Aşağıdaki örnek, her durumda oluşturucuya farklı bir bağlantı dizesi geçirerek birden çok OleDbConnectionStringBuilder örnek oluşturur. Bağlantıyla ilişkilendirilmiş sağlayıcının ayarlanmasının nesnenin koleksiyonundaki önceden tanımlanmış anahtar/değer çiftleri kümesini nasıl değiştirdiğine dikkat edin.
Not
Bu örnek, bağlantı dizeleriyle nasıl OleDbConnectionStringBuilder ç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.
using System.Data.OleDb;
class Program
{
static void Main()
{
try
{
// Build an empty instance, just to see
// the contents of the keys.
DumpBuilderContents("");
// Create a SQL Server connection string.
DumpBuilderContents("Provider=sqloledb;Data Source=(local);" +
"Initial Catalog=AdventureWorks;" +
"User Id=ab;Password=Password@1");
// Create an Access connection string.
DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
@"Data Source=C:\Sample.mdb");
// Create an Oracle connection string.
DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
"User Id=userName;Password=Pass@word1;");
// Create an Sybase connection string.
DumpBuilderContents("Provider=ASAProv;Data source=myASA");
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
catch (System.ArgumentException ex)
{
Console.WriteLine("Error: " + ex.Message);
}
}
private static void DumpBuilderContents(string connectString)
{
OleDbConnectionStringBuilder builder =
new OleDbConnectionStringBuilder(connectString);
Console.WriteLine("=================");
Console.WriteLine("Original connectString = " + connectString);
Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
foreach (string key in builder.Keys)
{
Console.WriteLine(key + "=" + builder[key].ToString());
}
}
}
Imports System.Data.OleDb
Module Module1
Sub Main()
Try
' Build an empty instance, just to see
' the contents of the keys.
DumpBuilderContents("")
' Create a SQL Server connection string.
DumpBuilderContents("Provider=sqloledb;Data Source=(local);" & _
"Initial Catalog=AdventureWorks;" & _
"User Id=ab;Password=Password@1")
' Create an Access connection string.
DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
"Data Source=C:\Sample.mdb")
' Create an Oracle connection string.
DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
"User Id=userName;Password=Pass@word1;")
' Create a Sybase connection string.
DumpBuilderContents("Provider=ASAProv;Data source=myASA")
Console.WriteLine("Press any key to finish.")
Console.ReadLine()
Catch ex As System.ArgumentException
Console.WriteLine("Error: " & ex.Message)
End Try
End Sub
Private Sub DumpBuilderContents(ByVal connectString As String)
Dim builder As New OleDbConnectionStringBuilder(connectString)
Console.WriteLine("=================")
Console.WriteLine("Original connectString = " & connectString)
Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
For Each key As String In builder.Keys
Console.WriteLine(key & "=" & builder.Item(key).ToString)
Next
End Sub
End Module
Açıklamalar
Provider Özelliğin doğrudan ayarlanması (özelliği ayarlayarakConnectionString) veya oluşturucuya parametre olarak bir bağlantı dizesi geçirilerek, örneğin içinde OleDbConnectionStringBuilder yer alan anahtar/değer çiftleri kümesini etkileyebilir. Provider Örneğin, özelliğini "sqloledb" olarak ayarlamak, tüm standart SQL bağlantı dizesi özelliklerini ekler. Bu davranışın bir gösterimi için bu konudaki örne bakın.
Bazı sağlayıcılar için oluşturucu içinde OleDbConnectionStringBuilder bir bağlantı dizesi atanması, sağlanan anahtar/değer çiftlerinin sırasının yeniden düzenlenmesine neden olur.