Click here to Skip to main content
6,822,123 members and growing! (17,734 online)
Email Password   helpLost your password?
Languages » C# » General     Beginner License: The Common Public License Version 1.0 (CPL)

SQLDoc Sharp

By Amit Chaudhary

SQLDoc Sharp, an interactive tool designed to generate the SQL Server 2005/2008 documentation.
C#, Windows, .NET, ADO.NET, Architect, DBA, Dev
Revision:4 (See All)
Posted:22 Apr 2009
Updated:23 Apr 2009
Views:7,336
Bookmarked:21 times
printPrint   add Share
      Discuss Discuss   Broken Article?Report  
5 votes for this article.
Popularity: 2.45 Rating: 3.50 out of 5
1 vote, 20.0%
1

2
2 votes, 40.0%
3
1 vote, 20.0%
4
1 vote, 20.0%
5

Introduction

SQLDoc Sharp is an interactive tool designed to generate the SQL Server 2005/2008 documentation.

It allows you to export documentation to CHM format (Microsoft Compiled HTML Help).
It is also easy and interactive, which allows multiple database documentation.
For more details, please refer to http://www.amitchaudhary.com/.

Background

Finding the answer to, "Is there any free tool for generating documentation from SQL 2005/2008".

Using the Code

After running the application, the initial UI looks like below:

SQLDocSharp.png

Three steps required to generate the documentation.

Step # 1

In the top section, provide the details about the SQL Server. It includes:

  1. Source: Instance Name of the SQL Server 2005/2008 
  2. If want to connect with SQL authentication then:
    1. User Name: Name of the user whose credentials you want to use
    2. Password: Password of the user whose credentials you want to use
  3. In case, to connect with Windows authentication then, only check the checkbox   (Integrated Security) and your current Windows credentials would be used to connect with the specified SQL Server Instance.

Step # 2

Choose the database name from the Database dropdown list, whose documentation you want to generate and then click on the Fetch button.

Meanwhile you can choose/change the File Name of the CHM file which would be generated. And also if required, you then choose to export the metadata/documentation in the XML format too.

Step # 3

Click on the Generate button. And locate the CHM file at the path specified.

After making the selection the SQLDoc Sharp, the UI should look like:

SQLDocSharp Step 2.png

Screen Shots of the Documentation Generated

Index

Index.png

Instance Information

Instance Information.png

Date Source Information

DataSource Information.png

Data Types

List of DataTypes.png

Users

List of Users.png

Tables

tables.png

Table Details

table details.png

Views

Views.png

Procedures

procedures.png

Functions

Functions.png

Triggers

Triggers.png

User Defined Data Types

UDDTs.png 

Points of Interest

At the time of writing the application, I got the opportunity to explore the SQL Server Metadata functions, stored procedures, etc. I also explored ADO.NET GetSchema, MetaCollections, etc. 

License

This article, along with any associated source code and files, is licensed under The Common Public License Version 1.0 (CPL)

About the Author

Amit Chaudhary


Member
An engineer with approx. 8 years of excellent experience in middle tier applications, analysis, design, development, testing, and maintenance of various client server/web based applications. Has the ability to handle multiple task(s), work independently as well as in team. Motivated, energetic with demonstrated proficiency for learning new technologies and business environments to provide effective and efficient IT solution(s) that envisage a futuristic approach with distributed and object oriented technologies.
Occupation: Architect
Location: India India

Other popular C# articles:

Article Top
You must Sign In to use this message board.
FAQ FAQ 
 
Noise Tolerance  Layout  Per page   
 Msgs 1 to 21 of 21 (Total in Forum: 21) (Refresh)FirstPrevNext
GeneralCheck/Uncheck/Toggle buttons and Check boxes PinmemberScotDance5:02 12 Jan '10  
GeneralTested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exe [modified] Pinmemberjohn blox4:01 29 Sep '09  
GeneralRe: Tested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exe PinmemberHanant9:18 11 Oct '09  
GeneralExcel, Pdf or XML PinmemberAmit Chaudhary20:34 6 Aug '09  
GeneralAgain it hangs Pinmembersore_ron4:51 15 May '09  
AnswerRe: Again it hangs PinmemberAmit Chaudhary21:01 17 May '09  
QuestionUnable to read CHM page with non-English object name Pinmemberdoggy_epaper.tw9:19 10 May '09  
GeneralMy vote of 1 Pinmemberpita20098:14 22 Apr '09  
AnswerRe: My vote of 1 PinmemberAmit Chaudhary8:40 25 Apr '09  
GeneralSQL Doc sharp Pinmemberwkww20045:08 22 Apr '09  
AnswerRe: SQL Doc sharp PinmemberAmit Chaudhary8:41 25 Apr '09  
Questionit didn't work Pinmembermahmola4:42 22 Apr '09  
AnswerRe: it didn't work Pinmembersmesser10:39 22 Apr '09  
AnswerRe: it didn't work PinmemberAmit Chaudhary8:41 25 Apr '09  
GeneralRe: it didn't work Pinmembersmesser13:00 25 Apr '09  
Questiongood but ... PinmemberMember 46177014:16 22 Apr '09  
AnswerRe: good but ... PinmemberAmit Chaudhary8:42 25 Apr '09  
GeneralGood, but ... PinmemberPeni3:26 22 Apr '09  
AnswerRe: Good, but ... PinmemberAmit Chaudhary3:27 22 Apr '09  
GeneralRe: Good, but ... PinmemberHenry Minute4:17 22 Apr '09  
AnswerRe: Good, but ... PinmemberAmit Chaudhary8:43 25 Apr '09  

General General    News News    Question Question    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads.

PermaLink | Privacy | Terms of Use
Last Updated: 23 Apr 2009
Editor: Deeksha Shenoy
Copyright 2009 by Amit Chaudhary
Everything else Copyright © CodeProject, 1999-2010
Web18 | Advertise on the Code Project