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 las cadenas literales connect, sql, userlist 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 (para obtener más información, consulte Windows 8 y la Guía de compatibilidad de Windows Server 2012, edición Cookbook). Los componentes de cliente de RDS se eliminarán en una versión futura de Windows. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Las aplicaciones que usan RDS deben migrar al 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 |
|---|---|
| connect | Cadena literal que modifica una cadena de conexión. |
| sql | Cadena literal que modifica una cadena de comandos. |
| userlist | Cadena literal que modifica los derechos de acceso de un usuario específico. |
| logs | Cadena literal que especifica un archivo de registro que registra errores operativos. |
| default | Cadena literal que se usa si no se especifica ni se encuentra ningún identificador. |
| identifier | Cadena que coincide con una cadena en la cadena connect o command. - Use esta sección si el encabezado de sección contiene conexión y la cadena de identificador 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 la userlist y la cadena de identificador coincide con un identificador de sección de conexión. |
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:
Se usa una sección connect si la parte de valor de la palabra clave de cadena de conexión del cliente, "Origen de datos=valor", coincide con un identificador de sección de conexión.
Se usa una sección sql si la cadena de comando del cliente contiene una cadena que coincide con un identificador de sección sql.
Se usa una sección connect o sql con un parámetro predeterminado si no hay ningún identificador coincidente.
Se usa una sección userlist si el identificador de sección userlist coincide con un identificador de sección connect. Si hay una coincidencia, el contenido de la sección userlist se aplica a la conexión regulada por la sección connect.
Si la cadena de una conexión o cadena de comando no coincide con el identificador de ningún encabezado de sección connect o sql, y no hay ningún encabezado de sección connect o sql con un parámetro predeterminado, la cadena de cliente se usa sin modificaciones.
La sección logs se usa cada vez que DataFactory está en funcionamiento.
Consulte también
Sección de conexión del archivo de personalización
Sección de registros del archivo de personalización
Sección de SQL del archivo de personalización
Sección UserList del archivo de personalización
Personalización de DataFactory
Configuración de cliente requerida
Escritura de un controlador personalizado