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 del 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 nueva entrada de configuración de conexión.

Devoluciones

DesignerDataConnection

Objeto DesignerDataConnection que contiene los datos de conexión guardados con la Name propiedad establecida nameen y la IsConfigured propiedad establecida trueen .

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 connectionStrings Element (ASP.NET Settings Schema) denominado según el name parámetro . La Name propiedad del connection parámetro se omite.

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

Exception	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 implementación del ConfigureConnection 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).