IDataEnvironment.ConfigureConnection Método

Definición

Espacio de nombres:

System.ComponentModel.Design.Data

Ensamblado:

System.Design.dll

Escribe una cadena de conexión en el archivo de configuración de la aplicación.

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

Parámetros

owner

IWin32Window

Ventana primaria para el cuadro de diálogo, si existe.

connection

DesignerDataConnection

Objeto DesignerDataConnection que contiene los datos de conexión que se van a guardar.

name

String

Nombre de la entrada de configuración de la nueva conexión.

Devoluciones

DesignerDataConnection

Objeto DesignerDataConnection que contiene los datos de conexión guardados, con la propiedad Name establecida en name y la propiedad IsConfigured establecida en true.

Comentarios

El ConfigureConnection método escribe una conexión al archivo de configuración de la aplicación. La cadena de conexión y el nombre del proveedor se escriben en el elemento de configuración connectionStrings Element (ASP.NET Settings Schema) denominado según el name parámetro . Se Name omite la propiedad del connection parámetro .

Las implementaciones del ConfigureConnection método deben producir las siguientes excepciones.

Excepción	Motivo
ArgumentException	Existe un nombre duplicado en el archivo de configuración de la aplicación.
FileNotFoundException, UnauthorizedAccessExceptionu otra excepción de E/S de archivo adecuada.	No se puede actualizar el archivo de configuración de la aplicación. La ConfigureConnection implementación del método debe producir una excepción adecuada.
CheckoutException	El archivo de configuración de la aplicación no se puede desprotegir desde el sistema de control de código fuente.

Considere la posibilidad de usar las API de administración de configuración en el System.Configuration espacio de nombres para leer y escribir el archivo de configuración de la aplicación. La ConnectionStringsSection clase leerá y escribirá el elemento de configuración connectionStrings Element (ASP.NET Settings Schema).