IDataEnvironment.ConfigureConnection Yöntem

Tanım

Ad Alanı:

System.ComponentModel.Design.Data

Bütünleştirilmiş Kod:

System.Design.dll

Uygulamanın yapılandırma dosyasına bir bağlantı dizesi yazar.

public:
 System::ComponentModel::Design::Data::DesignerDataConnection ^ ConfigureConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::String ^ name);

public System.ComponentModel.Design.Data.DesignerDataConnection ConfigureConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, string name);

abstract member ConfigureConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection * string -> System.ComponentModel.Design.Data.DesignerDataConnection

Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

Parametreler

owner

IWin32Window

Varsa iletişim kutusunun üst penceresi.

connection

DesignerDataConnection

DesignerDataConnection Kaydedilecek bağlantı verilerini içeren bir nesne.

name

String

Yeni bağlantı yapılandırma girişinin adı.

Döndürülenler

DesignerDataConnection

DesignerDataConnection Özelliği olarak, özelliği ise olarak ayarlanmış nameIsConfiguredtrueolarak kaydedilmiş bağlantı verilerini Name içeren bir nesne.

Açıklamalar

yöntemi, ConfigureConnection uygulamanın yapılandırma dosyasına bir bağlantı yazar. Bağlantı dizesi ve sağlayıcı adı, parametresine göre name adlı connectionStrings Öğesi (ASP.NET Ayarlar Şeması) yapılandırma öğesine yazılır. Name parametresinin connection özelliği yoksayılır.

yönteminin ConfigureConnection uygulamaları aşağıdaki özel durumları oluşturmalıdır.

Özel durum	Nedeni
ArgumentException	Uygulamanın yapılandırma dosyasında yinelenen bir ad var.
FileNotFoundException, UnauthorizedAccessExceptionveya diğer uygun dosya GÇ özel durumu.	Uygulamanın yapılandırma dosyası güncelleştirilemiyor. ConfigureConnection Yöntem uygulamanız uygun bir özel durum oluşturmalıdır.
CheckoutException	Uygulamanın yapılandırma dosyası kaynak denetim sisteminden kullanıma alınamıyor.

Uygulamanın yapılandırma dosyasını okumak ve yazmak için ad alanında System.Configuration yapılandırma yönetimi API'lerini kullanmayı göz önünde bulundurun. sınıfı connectionStrings Öğesi (ASP.NET Ayarlar Şeması) yapılandırma öğesini okur ve yazar.ConnectionStringsSection