How To Create a SQL Server Database Programmatically by Using ADO.NET and Visual C# .NET (307283)



The information in this article applies to:

  • Microsoft ADO.NET (included with the .NET Framework)
  • Microsoft ADO.NET (included with the .NET Framework 1.1)
  • Microsoft Visual C# .NET (2002)
  • Microsoft Visual C# .NET (2003)

This article was previously published under Q307283
For a Microsoft Visual Basic .NET version of this article, see 305079.
For a Microsoft Visual C++ .NET version of this article, see 307402.
For a Microsoft Visual J# .NET version of this article, see 320628.

This article refers to the following Microsoft .NET Framework Class Library namespace:
  • System.Data.SqlClient

IN THIS TASK

SUMMARY

This step-by-step article shows you how to create a Microsoft SQL Server database by using ADO.NET and Visual C# .NET because programmers often need to create Databases programmatically.

back to the top

Steps to Create a SQL Server Database

To create the database, follow these steps:
  1. Create a new Visual C# .NET Windows application.
  2. Place a button on Form1. Change the button's Name property to btnCreateDatabase, and then change the Text property to Create Database.
  3. Use the using statement on the System and System.Data namespaces so that you do not have to qualify declarations in those namespaces later in your code. Add the following code to the General Declarations section of Form1:
    using System;
    using System.Data.SqlClient;
    					
  4. Switch to Form view, and then double-click Create Database to add the click event handler. Add the following sample code to the handler:
        String str;
        SqlConnection myConn = new SqlConnection ("Server=localhost;Integrated security=SSPI;database=master");
    
        str = "CREATE DATABASE MyDatabase ON PRIMARY " +
            "(NAME = MyDatabase_Data, " +
            "FILENAME = 'C:\\MyDatabaseData.mdf', " +
            "SIZE = 2MB, MAXSIZE = 10MB, FILEGROWTH = 10%) " +
            "LOG ON (NAME = MyDatabase_Log, " +
            "FILENAME = 'C:\\MyDatabaseLog.ldf', " +
            "SIZE = 1MB, " +
            "MAXSIZE = 5MB, " +
            "FILEGROWTH = 10%)";
    
        SqlCommand myCommand = new SqlCommand(str, myConn);
        try 
        {
            myConn.Open();
    	myCommand.ExecuteNonQuery();
    	MessageBox.Show("DataBase is Created Successfully", "MyProgram", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (System.Exception ex)
        {
    	MessageBox.Show(ex.ToString(), "MyProgram", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        finally
        {
    	if (myConn.State == ConnectionState.Open)
    	{
    	    myConn.Close();
    	}
        }
    					
  5. Change the connection string to point to your computer running SQL Server, and then verify that the Database argument is set to Master or is blank.
  6. Press F5 or CTRL+F5 to run the project, and then click Create Database.
  7. Use the Server Explorer to verify that the database is created.
back to the top

NOTES:

  • This code creates a custom database with specific properties.
  • The folder that is going to hold the created .mdf and .ldf files must already exist before you run the code or an exception will be generated.
  • If you want to create a database that is similar to the SQL Server Model database, and you want the database in the default location, then change the str variable in the code, as in the following sample code:
    str = "CREATE DATABASE MyDatabase"
    					
back to the top

REFERENCES

For additional information about the Create Database Transact-SQL command, see the SQL Server Books Online or visit the MSDN Online Library: For more information about ADO.NET objects and syntax, see the following topic in the Microsoft .NET Framework SDK Documentation or visit the following Microsoft Web site: back to the top

Modification Type:MinorLast Reviewed:6/29/2004
Keywords:kbHOWTOmaster kbSqlClient kbSystemData KB307283 kbAudDeveloper