Visual C# 2010 Recipes solution_4 doc

CHAPTER 9 ■ DATABASE ACCESS 450 The Code The following example demonstrates how to retrieve results as XML using the FOR XML clause and the ExecuteXmlReader method: using System; using System.Xml; using System.Data; using System.Data.SqlClient; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_08 { public static void ConnectedExample() { // Create a new SqlConnection object. using (SqlConnection con = new SqlConnection()) { // Configure the SqlConnection object's connection string. con.ConnectionString = @"Data Source = .\sqlexpress;" + "Database = Northwind; Integrated Security=SSPI"; // Create and configure a new command that includes the // FOR XML AUTO clause. using (SqlCommand com = con.CreateCommand()) { com.CommandType = CommandType.Text; com.CommandText = "SELECT CustomerID, CompanyName" + " FROM Customers FOR XML AUTO"; // Open the database connection. con.Open(); // Execute the command and retrieve an XmlReader to access // the results. using (XmlReader reader = com.ExecuteXmlReader()) { while (reader.Read()) { Console.Write("Element: " + reader.Name); if (reader.HasAttributes) { for (int i = 0; i < reader.AttributeCount; i++) { reader.MoveToAttribute(i); Console.Write(" {0}: {1}", reader.Name, reader.Value); } CHAPTER 9 ■ DATABASE ACCESS 451 // Move the XmlReader back to the element node. reader.MoveToElement(); Console.WriteLine(Environment.NewLine); } } } } } } public static void DisconnectedExample() { XmlDocument doc = new XmlDocument(); // Create a new SqlConnection object. using (SqlConnection con = new SqlConnection()) { // Configure the SqlConnection object's connection string. con.ConnectionString = @"Data Source = .\sqlexpress;" + "Database = Northwind; Integrated Security=SSPI"; // Create and configure a new command that includes the // FOR XML AUTO clause. SqlCommand com = con.CreateCommand(); com.CommandType = CommandType.Text; com.CommandText = "SELECT CustomerID, CompanyName FROM Customers FOR XML AUTO"; // Open the database connection. con.Open(); // Load the XML data into the XmlDocument. Must first create a // root element into which to place each result row element. XmlReader reader = com.ExecuteXmlReader(); doc.LoadXml("<results></results>"); // Create an XmlNode from the next XML element read from the // reader. XmlNode newNode = doc.ReadNode(reader); while (newNode != null) { doc.DocumentElement.AppendChild(newNode); newNode = doc.ReadNode(reader); } } // Process the disconnected XmlDocument. Console.WriteLine(doc.OuterXml); } CHAPTER 9 ■ DATABASE ACCESS 452 public static void Main(string[] args) { ConnectedExample(); Console.WriteLine(Environment.NewLine); DisconnectedExample(); Console.WriteLine(Environment.NewLine); // Wait to continue. Console.WriteLine(Environment.NewLine); Console.WriteLine("Main method complete. Press Enter."); Console.ReadLine(); } } } 9-9. Perform Asynchronous Database Operations Against SQL Server Problem You need to execute a query or command against a SQL Server database as a background task while your application continues with other processing. Solution Use the BeginExecuteNonQuery, BeginExecuteReader, or BeginExecuteXmlReader method of the System.Data.SqlClient.SqlCommand class to start the database operation as a background task. These methods all return a System.IAsyncResult object that you can use to determine the operation’s status or use thread synchronization to wait for completion. Use the IAsyncResult object and the corresponding EndExecuteNonQuery, EndExecuteReader, or EndExecuteXmlReader method to obtain the result of the operation. ■ Note Only the SqlCommand class supports the asynchronous operations described in this recipe. The equivalent command classes for the Oracle, SQL Server CE, ODBC, and OLE DB data providers do not provide this functionality. How It Works You will usually execute operations against databases synchronously, meaning that the calling code blocks until the operation is complete. Synchronous calls are most common because your code will CHAPTER 9 ■ DATABASE ACCESS 453 usually require the result of the operation before it can continue. However, sometimes it’s useful to execute a database operation asynchronously, meaning that you start the method in a separate thread and then continue with other operations. ■ Note To execute asynchronous operations over a System.Data.SqlClient.SqlConnection connection, you must specify the value Asynchronous Processing=true in its connection string. The SqlCommand class implements the asynchronous execution pattern similar to that discussed in recipe 4-2. As with the general asynchronous execution pattern described in recipe 4-2, the arguments of the asynchronous execution methods (BeginExecuteNonQuery, BeginExecuteReader, and BeginExecuteXmlReader) are the same as those of the synchronous variants (ExecuteNonQuery, ExecuteReader, and ExecuteXmlReader), but they take the following two additional arguments to support asynchronous completion: • A System.AsyncCallback delegate instance that references a method that the runtime will call when the asynchronous operation completes. The method is executed in the context of a thread-pool thread. Passing null means that no method is called and you must use another completion mechanism (discussed later in this recipe) to determine when the asynchronous operation is complete. • An object reference that the runtime associates with the asynchronous operation. The asynchronous operation does not use nor have access to this object, but it’s available to your code when the operation completes, allowing you to associate useful state information with an asynchronous operation. For example, this object allows you to map results against initiated operations in situations where you initiate many asynchronous operations that use a common callback method to perform completion. The EndExecuteNonQuery, EndExecuteReader, and EndExecuteXmlReader methods allow you to retrieve the return value of an operation that was executed asynchronously, but you must first determine when it has finished. Here are the four techniques for determining if an asynchronous method has finished: • Blocking: This method stops the execution of the current thread until the asynchronous operation completes execution. In effect, this is much the same as synchronous execution. However, in this case, you have the flexibility to decide exactly when your code enters the blocked state, giving you the opportunity to carry out some additional processing before blocking. • Polling: This method involves repeatedly testing the state of an asynchronous operation to determine whether it’s complete. This is a very simple technique and is not particularly efficient from a processing perspective. You should avoid tight loops that consume processor time. It’s best to put the polling thread to sleep for a period using Thread.Sleep between completion tests. Because polling involves maintaining a loop, the actions of the waiting thread are limited, but you can easily update some kind of progress indicator. CHAPTER 9 ■ DATABASE ACCESS 454 • Waiting: This method uses an object derived from the System.Threading.WaitHandle class to signal when the asynchronous method completes. Waiting is a more efficient version of polling and in addition allows you to wait for multiple asynchronous operations to complete. You can also specify timeout values to allow your waiting thread to fail if the asynchronous operation takes too long, or if you want to periodically update a status indicator. • Callback: This a method that the runtime calls when an asynchronous operation completes. The calling code does not need to take any steps to determine when the asynchronous operation is complete and is free to continue with other processing. Callbacks provide the greatest flexibility, but also introduce the greatest complexity, especially if you have many concurrently active asynchronous operations that all use the same callback. In such cases, you must use appropriate state objects to match completed methods against those you initiated. ■ Caution When using the asynchronous capabilities of the SQL Server data provider, you must ensure that your code does not inadvertently dispose of objects that are still being used by other threads. Pay particular attention to SqlConnection and SqlCommand objects. The Code Recipe 4-2 provides examples of all of the completion techniques summarized in the preceding list. The following example demonstrates the use of an asynchronous call to execute a stored procedure on a SQL Server database. The code uses a callback to process the returned result set. using System; using System.Data; using System.Threading; using System.Data.SqlClient; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_09 { // A method to handle asynchronous completion using callbacks. public static void CallbackHandler(IAsyncResult result) { // Obtain a reference to the SqlCommand used to initiate the // asynchronous operation. using (SqlCommand cmd = result.AsyncState as SqlCommand) { // Obtain the result of the stored procedure. using (SqlDataReader reader = cmd.EndExecuteReader(result)) { CHAPTER 9 ■ DATABASE ACCESS 455 // Display the results of the stored procedure to the console. lock (Console.Out) { Console.WriteLine( "Price of the Ten Most Expensive Products:"); while (reader.Read()) { // Display the product details. Console.WriteLine(" {0} = {1}", reader["TenMostExpensiveProducts"], reader["UnitPrice"]); } } } } } public static void Main() { // Create a new SqlConnection object. using (SqlConnection con = new SqlConnection()) { // Configure the SqlConnection object's connection string. // You must specify Asynchronous Processing=true to support // asynchronous operations over the connection. con.ConnectionString = @"Data Source = .\sqlexpress;" + "Database = Northwind; Integrated Security=SSPI;" + "Asynchronous Processing=true"; // Create and configure a new command to run a stored procedure. // Do not wrap it in a using statement because the asynchronous // completion handler will dispose of the SqlCommand object. SqlCommand cmd = con.CreateCommand(); cmd.CommandType = CommandType.StoredProcedure; cmd.CommandText = "Ten Most Expensive Products"; // Open the database connection and execute the command // asynchronously. Pass the reference to the SqlCommand // used to initiate the asynchronous operation. con.Open(); cmd.BeginExecuteReader(CallbackHandler, cmd); CHAPTER 9 ■ DATABASE ACCESS 456 // Continue with other processing. for (int count = 0; count < 10; count++) { lock (Console.Out) { Console.WriteLine("{0} : Continue processing ", DateTime.Now.ToString("HH:mm:ss.ffff")); } Thread.Sleep(500); } } // Wait to continue. Console.WriteLine(Environment.NewLine); Console.WriteLine("Main method complete. Press Enter."); Console.ReadLine(); } } } 9-10. Write Database-Independent Code Problem You need to write code that can be configured to work against any relational database supported by an ADO.NET data provider. Solution Program to the ADO.NET data provider interfaces in the System.Data namespace, as opposed to the concrete implementations, and do not rely on features and data types that are unique to specific database implementations. Use factory classes and methods to instantiate the data provider objects you need to use. How It Works Using a specific data provider implementation (the SQL Server data provider, for example) simplifies your code, and may be appropriate if you need to support only a single type of database or require access to specific features provided by that data provider, such as the asynchronous execution for SQL Server detailed in recipe 9-9. However, if you program your application against a specific data provider implementation, you will need to rewrite and test those sections of your code if you want to use a different data provider at some point in the future. Table 9-6 contains a summary of the main interfaces you must program against when writing generic ADO.NET code that will work with any relational database’s data provider. The table also explains how to create objects of the appropriate type that implement the interface. Many of the recipes CHAPTER 9 ■ DATABASE ACCESS 457 in this chapter demonstrate the use of ADO.NET data provider interfaces over specific implementation, as highlighted in the table. Table 9-6. Data Provider Interfaces Interface Description Demonstrated In IDbConnection Represents a connection to a relational database. You must program the logic to create a connection object of the appropriate type based on your application’s configuration information, or use the DbProviderFactory.CreateConnection factory method (discussed in this recipe). Recipe 9-1 IDbCommand Represents a SQL command that is issued to a relational database. You can create IDbCommand objects of the appropriate type using the IDbConnection.CreateCommand or DbProviderFactory.CreateCommand factory method. Recipe 9-5 IDataParameter Represents a parameter to an IDbCommand object. You can create IDataParameter objects of the correct type using the IDbCommand.CreateParameter, IDbCommand.Parameters.Add, or DbProviderFactory.CreateParameter factory method. Recipe 9-6 IDataReader Represents the result set of a database query and provides access to the contained rows and columns. An object of the correct type will be returned when you call the IDbCommand.ExecuteReader method. Recipes 9-5 and 9-6 IDbDataAdapter Represents the set of commands used to fill a System.Data.DataSet from a relational database and to update the database based on changes to the DataSet. You must program the logic to create a data adapter object of the appropriate type based on your application’s configuration information, or use the DbProviderFactory.CreateAdapter factory method (discussed in this recipe). The System.Data.Common.DbProviderFactory class provides a set of factory methods for creating all types of data provider objects, making it very useful for implementing generic database code. Most important, DbProviderFactory provides a mechanism for obtaining an initial IDbConnection instance, which is the critical starting point for writing generic ADO.NET code. Each of the standard data provider implementations (except the SQL Server CE data provider) includes a unique factory class derived from DbProviderFactory. Here is the list of DbProviderFactory subclasses: CHAPTER 9 ■ DATABASE ACCESS 458 • System.Data.Odbc.OdbcFactory • System.Data.OleDb.OleDbFactory • System.Data.OracleClient.OracleClientFactory • System.Data.SqlClient.SqlClientFactory You can obtain an instance of the appropriate DbProviderFactory subclass using the DbProviderFactories class, which is effectively a factory of factories. Each data provider factory is described by configuration information in the machine.config file, similar to that shown here for the SQL Server data adapter. This can be changed or overridden by application-specific configuration information if required. <configuration> <system.data> <DbProviderFactories> <add name="SqlClient Data Provider" invariant="System.Data.SqlClient" ~CCC description=".Net Framework Data Provider for SqlServer" type= ~CCC "System.Data.SqlClient.SqlClientFactory, System.Data, Version=2.0.0.0, ~CCC Culture=neutral, PublicKeyToken=b77a5c561934e089" /> <add name="Odbc Data Provider" /> <add name="OleDb Data Provider" /> <add name="OracleClient Data Provider" /> <add name="SQL Server CE Data /> </DbProviderFactories> </system.data> </configuration> You can enumerate the available data provider factories by calling DbProviderFactories. GetFactoryClasses, which returns a System.Data.DataTable containing the following columns: • Name, which contains a human-readable name for the provider factory. Taken from the name attribute in the configuration information. • Description, which contains a human-readable description for the provider factory. Taken from the description attribute of the configuration information. • InvariantName, which contains the unique name used to refer to the data provider factory programmatically. Taken from the invariant attribute of the configuration information. • AssemblyQualifiedName, which contains the fully qualified name of the DbProviderFactory class for the data provider. Taken from the type attribute of the configuration information. Normally, you would allow the provider to be selected at install time or the first time the application is run, and then store the settings as user or application configuration data. The most important piece of information is the InvariantName, which you pass to the DbProviderFactories.GetFactory method to obtain the DbProviderFactory implementation you will use to create your IDbConnection instances. CHAPTER 9 ■ DATABASE ACCESS 459 The Code The following example demonstrates the enumeration of all data providers configured for the local machine and application. It then uses the DbProviderFactories class to instantiate a DbProviderFactory object (actually a SqlClientFactory) from which it creates the appropriate IDbConnection. It then uses the factory methods of the data provider interfaces to create other required objects, resulting in code that is completely generic. using System; using System.Data; using System.Data.Common; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_10 { public static void Main(string[] args) { // Obtain the list of ADO.NET data providers registered in the // machine and application configuration files. using (DataTable providers = DbProviderFactories.GetFactoryClasses()) { // Enumerate the set of data providers and display details. Console.WriteLine("Available ADO.NET Data Providers:"); foreach (DataRow prov in providers.Rows) { Console.WriteLine(" Name:{0}", prov["Name"]); Console.WriteLine(" Description:{0}", prov["Description"]); Console.WriteLine(" Invariant Name:{0}", prov["InvariantName"]); } } // Obtain the DbProviderFactory for SQL Server. The provider to use // could be selected by the user or read from a configuration file. // In this case, we simply pass the invariant name. DbProviderFactory factory = DbProviderFactories.GetFactory("System.Data.SqlClient"); // Use the DbProviderFactory to create the initial IDbConnection, and // then the data provider interface factory methods for other objects. using (IDbConnection con = factory.CreateConnection()) { // Normally, read the connection string from secure storage. // See recipe 9-3. In this case, use a default value. con.ConnectionString = @"Data Source = .\sqlexpress;" + "Database = Northwind; Integrated Security=SSPI"; [...]... recipes that demonstrate LINQ features The Code The following example creates a DataSet that contains a DataTable with all of the rows of the Northwind Region table, and then performs a LINQ query using the DataTable as the data source: using using using using using using System; System.Collections.Generic; System.Linq; System.Text; System.Data; System.Data.SqlClient; namespace Apress.VisualCSharpRecipes.Chapter09... distributed communications, like message queues The recipes in this chapter describe how to do the following: • Obtain configuration and network statistic information about the network interfaces on a computer as well as detect when network configuration changes occur (recipes 10-1 and 10-2) • Download files from File Transfer Protocol (FTP) and HTTP servers (recipes 10-3, 10-4, and 10-6) • Respond to HTTP... Manipulate uniform resource locators (URIs) (recipe 10-16) ■ Tip A number of the recipes in this chapter include a client and a server component that must both be running for the recipe to work correctly Where this is the case, the client and server code are contained in separate projects To run these recipes from within Visual Studio, set the server project as the startup project and run it normally... accessible (and visible) on the network The IsClustered and Version columns may be blank for some versions of SQL Server using System; using System.Data; using System.Data.Sql; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_11 { public static void Main(string[] args) { // Obtain the DataTable of SQL Server instances using (DataTable SqlSources = SqlDataSourceEnumerator.Instance.GetDataSources())... using using using using using using System; System.Collections.Generic; System.Linq; System.Text; System.Data; System.Data.SqlClient; System.Data.Linq; System.Data.Linq.Mapping; namespace Apress.VisualCSharpRecipes.Chapter09 { [Table(Name = "Region")] public partial class Region { [Column] public int RegionID; [Column] public string RegionDescription; } class Recipe09_15 { static void Main(string[]... and Except methods to compare the results: using using using using using using System; System.Collections.Generic; System.Linq; System.Text; System.Data; System.Data.SqlClient; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_16 { static void Main(string[] args) { // Create a new SqlConnection object using (SqlConnection con = new SqlConnection()) { 474 CHAPTER 9 ■ DATABASE ACCESS //... printed out A new record is added and an existing one modified before the changes are written back to the database using System; using System.Data; using System.Data.SqlClient; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_12 { static void Main(string[] args) { // Create a new SqlConnection object using (SqlConnection con = new SqlConnection()) { // Configure the SqlConnection object's... populates it with instances of DataRow Once populated, the same queries, modifications, and additions are performed upon it as in the previous recipe using System; sing System.Data; namespace Apress.VisualCSharpRecipes.Chapter09 { class Recipe09_13 { static void Main(string[] args) { // Create the data set DataSet dataset = new DataSet(); // Create the table and add it to the data set DataTable table =... example uses the members of the NetworkInterface class to display information about all the network interfaces on the local machine: using System; using System.Net.NetworkInformation; namespace Apress.VisualCSharpRecipes.Chapter10 { class Recipe10_01 { static void Main() { // Only proceed if there is a network available if (NetworkInterface.GetIsNetworkAvailable()) { // Get the set of all NetworkInterface... your network cable while the example is running, wait a few seconds, and then plug the cable back in 484 CHAPTER 10 ■ NETWORKING using System; using System.Net.NetworkInformation; namespace Apress.VisualCSharpRecipes.Chapter10 { class Recipe10_02 { // Declare a method to handle NetworkAvailabilityChanged events private static void NetworkAvailabilityChanged( object sender, NetworkAvailabilityEventArgs . newNode = doc. ReadNode(reader); while (newNode != null) { doc. DocumentElement.AppendChild(newNode); newNode = doc. ReadNode(reader); } } // Process the disconnected XmlDocument Data 4 Southern Data 5 Central Main method complete. Press Enter. 9- 14. Perform a LINQ Query Problem You need to use LINQ to query a database. CHAPTER 9 ■ DATABASE ACCESS 46 9 Solution. Console.WriteLine(Environment.NewLine); } } } } } } public static void DisconnectedExample() { XmlDocument doc = new XmlDocument(); // Create a new SqlConnection object. using (SqlConnection con = new