Descripción del archivo de personalización
Cada encabezado de sección del archivo de personalización consta de corchetes ([]) que contienen un tipo y un parámetro. Los cuatro tipos de sección se indican mediante los strings literales connect, sql, lista de usuarios, o logs. El parámetro es la cadena literal, el valor predeterminado, un identificador especificado por el usuario o nada.
Importante
A partir de Windows 8 y Windows Server 2012, los componentes del servidor RDS ya no se incluyen en el sistema operativo Windows (consulte Windows 8 y Guía de compatibilidad de Windows Server 2012 para obtener más detalles). Los componentes de cliente de RDS se quitarán en una versión futura de Windows. Evite usar esta característica en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que actualmente usan esta característica. Las aplicaciones que usan RDS deben migrar a servicio de datos WCF.
Por lo tanto, cada sección se marca con uno de los encabezados de sección siguientes:
[ connect default ] [ connect
identifier
] [ sql default ] [ sql
identifier
] [ userlist
identifier
] [ logs ]
Los encabezados de sección tienen las siguientes partes.
| Parte | Descripción |
|---|---|
| conectar | Cadena literal que modifica una cadena de conexión. |
| sql | Cadena literal que modifica una cadena de comandos. |
| lista de usuarios | Cadena literal que modifica los derechos de acceso de un usuario específico. |
| registros | Cadena literal que especifica un archivo de registro para grabar errores operativos. |
| predeterminado | Cadena literal que se usa si no se especifica ni se encuentra ningún identificador. |
| identificador | Una cadena que coincide con una cadena en el comando conectar o . - Use esta sección si el encabezado de sección contiene connect y la cadena de identificadores se encuentra en la cadena de conexión. : use esta sección si el encabezado de sección contiene sql y la cadena de identificador se encuentra en la cadena de comandos. - Use esta sección si el encabezado de sección contiene userlist y la cadena de identificador coincide con un identificador de sección de conectar. |
El DataFactory llama al controlador y pasa parámetros de cliente. El controlador busca cadenas completas en los parámetros de cliente que coinciden con identificadores en los encabezados de sección adecuados. Si se encuentra una coincidencia, el contenido de esa sección se aplica al parámetro de cliente.
En las siguientes circunstancias se usa una sección determinada:
Una sección de conexión se utiliza si la parte del valor de la palabra clave de la cadena de conexión del cliente, "Data Source=valor", coincide con un identificador de sección de conexión .
Se usa una sección sql si la cadena de comandos del cliente contiene una que coincide con un identificador de sección sql.
Se utiliza una sección connect o sql con un parámetro predeterminado si no hay un identificador coincidente.
Se utiliza una sección de lista de usuarios si el identificador de sección de lista de usuarios coincide con un identificador de sección de conexión . Si hay una coincidencia, el contenido de la sección userlist se aplica a la conexión regulada por la sección conexión.
Si la cadena en una conexión o cadena de comandos no coincide con el identificador en ningún encabezado de sección connect o sql, y no hay un encabezado de sección connect o sql con un parámetro predeterminado, entonces la cadena del cliente se usa sin modificación.
La sección de registros se utiliza cada vez que el DataFactory está en funcionamiento.
Consulte también
sección de conexión de archivo de personalización
Sección de Registros de Archivos de Personalización
sección SQL del archivo de personalización
sección UserList del archivo de personalización
Personalización de DataFactory
Configuración de Cliente Requerida
Escribir su propio controlador personalizado