Tài liệu Using ADO.NET Design-Time Features in Classes Without a GUI pptx

Solution Create a component and use its design-time functionality.. To create the component Component0717.cs, add two controls to its design surface: • Drop a SqlDataAdapter onto the

[ Team LiB ]

Recipe 7.17 Using ADO.NET Design-Time Features in Classes Without a GUI

Problem

The design-time environment provides controls and wizards to facilitate creation of and management of properties of ADO.NET objects You want to use that design-time

functionality when creating classes that do not have a GUI

Solution

Create a component and use its design-time functionality

The solution contains two parts: the component and the test container for the component

To create the component Component0717.cs, add two controls to its design surface:

• Drop a SqlDataAdapter onto the design surface and use the Data Adapter

Configuration Wizard to connect to the Northwind sample database on the local SQL Server Accept all wizard defaults; supply the following SQL statement when prompted to generate the SQL statements:

• SELECT

• OrderID,

• CustomerID,

• EmployeeID,

• OrderDate,

• RequiredDate,

• ShippedDate,

• ShipVia,

• Freight,

• ShipName,

• ShipAddress,

• ShipCity,

• ShipRegion,

• ShipPostalCode,

• ShipCountry

• FROM

Orders

After the wizard completes, rename the SqlDataAdapter control to da

• A SqlConnection control is automatically added to the design surface when the

SqlDataAdapter wizard is completed; rename it to conn

The sample code for the component exposes one property and one method:

MyDataTable

A read-only property that returns a DataTable filled using the SqlDataAdapter control

Update( )

This method takes a DataTable object argument that uses the SqlDataAdapter control to update changes to the DataTable (retrieved using the MyDataTable property of the component) back to the database

The C# code for the component is shown in Example 7-33

Example 7-33 File: Component0717.cs

// Namespaces, variables, and constants

using System;

using System.Data;

using System.Data.SqlClient;

//

public DataTable MyDataTable

{

get

{

// Fill a table using the DataAdapter control

DataTable dt = new DataTable( );

da.Fill(dt);

return dt;

}

}

public void Update(DataTable dt)

{

// Update the table back to the data source

da.Update(dt);

}

The test container sample code contains two event handlers:

Form.Load

Instantiates the component Component0717 and binds the default view of the

DataTable that it exposes (through the MyDataTable property) to the DataGrid on the form

Update Button.Click

Instantiates the component Component0717 and calls the Update( ) method of the

component to update changes made in the DataGrid to the DataTable retrieved in the Form.Load event handler

The C# code for the test container is shown in Example 7-34

Example 7-34 File: UsingDesignTimeFeauresWithComponentsForm.cs

// Namespaces, variables, and constants

using System;

using System.Data;

//

private void UsingDesignTimeFeauresWithComponentsForm_Load(object sender, System.EventArgs e)

{

// Bind the default of the table from the component to the grid

Component0717 c = new Component0717( );

dataGrid.DataSource = c.MyDataTable.DefaultView;

}

private void updateButton_Click(object sender, System.EventArgs e)

{

// Update the table to the data source using the component

Component0717 c = new Component0717( );

c.Update(((DataView)dataGrid.DataSource).Table);

}

Discussion

The component and control are special-purpose classes in the NET Framework:

• A component is a class that implements the IComponent interface or inherits from

a class that implements that interface, such as

System.ComponentModel.Component A component has no user interface; it supports a visual design surface similar to the component tray on controls with a visual design surface that you can use to add or arrange components used by the component The arrangement of components on the design surface is not important because there is no user interface for a component

• A control is a component that provides user interface functionality and inherits from the System.Windows.Forms.Control class, which in turn derives from the Component A control is a component, but a component is not necessarily a

control

To create a component, simply right-click on a project or folder in the Solution Explorer window and select Add Add Component The View Designer button in the Solution Explorer window accesses the design surface of the component

[ Team LiB ]