IDataEnvironment.ConfigureConnection 메서드

정의

네임스페이스:

System.ComponentModel.Design.Data

어셈블리:

System.Design.dll

애플리케이션의 구성 파일에 연결 문자열을 씁니다.

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

매개 변수

owner

IWin32Window

대화 상자의 부모 창입니다(있는 경우).

connection

DesignerDataConnection

저장할 연결 데이터를 포함하는 DesignerDataConnection 개체입니다.

name

String

새 연결 구성 엔트리의 이름입니다.

반환

DesignerDataConnection

DesignerDataConnection 속성이 name으로 설정되고 Name 속성이 true로 설정되어 저장된 연결 데이터를 포함하는 IsConfigured 개체입니다.

설명

ConfigureConnection 메서드는 애플리케이션의 구성 파일에 연결을 기록 합니다. 연결 문자열과 공급자 이름은 기록 되는 connectionStrings 요소 (ASP.NET 설정 스키마) 구성 요소에 따라 지정 된 name 매개 변수. Name 속성은 connection 매개 변수는 무시 됩니다.

구현 된 ConfigureConnection 메서드는 다음 예외를 throw 해야 합니다.

예외	이유
ArgumentException	애플리케이션의 구성 파일에 중복 된 이름이 있습니다.
FileNotFoundException UnauthorizedAccessException, 또는 다른 적절 한 파일 IO 예외입니다.	애플리케이션의 구성 파일을 업데이트할 수 없습니다. 해당 ConfigureConnection 적절 한 예외를 throw 하는 메서드를 구현 해야 합니다.
CheckoutException	소스 제어 시스템에서 애플리케이션의 구성 파일을 체크 아웃할 수 없습니다.

구성 관리 Api를 사용 하는 것이 좋습니다는 System.Configuration 네임 스페이스를 읽고 쓰는 애플리케이션의 구성 파일입니다. ConnectionStringsSection 클래스는 읽기 및 쓰기는 connectionStrings 요소 (ASP.NET 설정 스키마) 구성 요소입니다.