Cómo poblar un conjunto de datos del archivo de hosts desde el adaptador de datos

El conjunto de datos es una representación residente en memoria de los datos que proporciona un modelo de programación relacional coherente independientemente del origen de datos. El conjunto de datos representa un conjunto completo de datos, incluidas tablas, restricciones y relaciones entre las tablas. Dado que el conjunto de datos es independiente del origen de datos, un conjunto de datos puede incluir datos locales en la aplicación y también datos de varios orígenes de datos. La interacción con orígenes de datos existentes se controla mediante el DataAdapter objeto .

La HostfileDataAdapter.SelectCommand propiedad es un HostFileCommand objeto que recupera datos del origen de datos. El HostFileDataAdapter.Fill método se usa para rellenar un conjunto de datos con los resultados de SelectCommand. Fill toma como argumentos un DataSet objeto que se va a rellenar, y un DataTable objeto o el nombre del DataTable que se va a completar con las filas devueltas del SelectCommand.

El Fill método usa el HostFileDataReader objeto implícitamente para devolver los nombres y tipos de columna utilizados para crear las tablas en el DataSet objeto y también los datos para rellenar las filas de las tablas del DataSet objeto . Las tablas y columnas solo se crean cuando no existen; en caso contrario, Fill utiliza el esquema existente de DataSet . Las claves principales no se crean a menos que estén en el origen de datos y HostFileDataAdapter.MissingSchemaAction se establezca en MissingSchemaAction.AddWithKey. Si Fill encuentra que existe una clave principal para una tabla, sobrescribe los datos del DataSet objeto con datos del origen de datos para las filas donde los valores de columna de clave principal coinciden con los de la fila devuelta desde el origen de datos. Si no se encuentra ninguna clave principal, los datos se anexan a las tablas del DataSet objeto . Fill usa las asignaciones que puedan existir al rellenar el objeto DataSet.

Si encuentra HostFileDataAdapter varios conjuntos de resultados, crea varias tablas en el DataSet objeto . Las tablas reciben un nombre predeterminado incremental de TableN, empezando por "Table" para Table0. Si se pasa un nombre de tabla como argumento al Fill método , las tablas reciben un nombre predeterminado incremental de TableNameN, empezando por "TableName" para TableName0.

Puede usar cualquier cantidad de objetos HostFileDataAdapter con un objeto DataSet. Cada DataAdapter objeto se puede usar para rellenar uno o varios DataTable objetos y gestionar las actualizaciones de vuelta al origen de datos correspondiente. Puede agregar DataRelation y Constraint a DataSet localmente, lo que le permite relacionar datos de orígenes de datos diferentes. La comunicación con cada origen de datos se puede controlar usando uno o varios objetos DataAdapter .

Para rellenar un conjunto de datos de archivo host desde el adaptador de datos

  1. Cree una nueva conexión al origen de datos mediante HostFileConnection.

  2. Abra la conexión mediante HostFileConnection.Open.

  3. Cree un comando SELECT que describa los datos que se van a recuperar con HostFileCommand.

  4. Crear un HostFileDataAdapter usando HostFileConnection para interactuar con los datos almacenados.

  5. Cree un DataSet objeto para almacenar los datos localmente.

  6. Recupere los datos a través de HostFileDataAdapter usando el objeto DataSet y el comando Fill.

Ejemplo

En el ejemplo de código siguiente se muestra cómo rellenar un conjunto de datos a través de .HostFileDataAdapter En este ejemplo, los objetos ETCMLogging y HostFileUtils proporcionan funcionalidad de registro y utilidad, respectivamente.

public void HFDAdapterCommandConstructor(ETCMLogging.Logging logging, string host, string ccsid, string cnstring, HostFileUtils.Utils.HostFileType hostfiletype)  
        {  
            HostFileUtils.Utils u = new HostFileUtils.Utils();  
            logging.LogInfo(host + "::" + hostfiletype.ToString());  
            HostFileUtils.Utils.MytestsVals[] Datavals = u.InitMytestsVals();  
  
            try  
            {  
                HostFileConnection cn = new HostFileConnection(cnstring);  
                cn.Open();  
                String SELECT = u.CreateSQLCommand(host, hostfiletype, cnstring, "SELECT", "MYTEST");  
                HostFileCommand hfc = new HostFileCommand(SELECT, cn);  
                HostFileDataAdapter hfda = new HostFileDataAdapter(hfc);  
                DataSet ds = new DataSet();  
                hfda.Fill(ds);  
                int[] cp = u.CheckColumns(SELECT, cn, logging);  
                u.ValidateDataSet(ds, logging, Datavals, cp);  
  
                cn.Close();  
            }  
            catch (Exception e)  
            {  
                logging.LogInfo(e.Message);  
                logging.LogFail(e.StackTrace);  
            }  
        }

En este ejemplo de código, el HostFileUtils objeto y los cnstring parámetros y ccsid permiten crear rápidamente un comando SQL de prueba con la información pertinente.

Véase también

Trabajar con el adaptador de archivos host y el conjunto de datos
Configuración del adaptador de BizTalk para archivos host

  • Last updated on