Click here to Skip to main content
12,635,011 members (30,145 online)
Click here to Skip to main content
Add your own
alternative version

Stats

115K views
820 downloads
77 bookmarked
Posted

Modifying Web.Config During Installation

, 26 Jan 2006
Rate this:
Please Sign up or sign in to vote.
How to modify the Web.Config of a WebService during installation.

Abstract

This application illustrates an installer that changes the values in a webservice's web.config file during setup, according to user entry. The application changes values of key values in the web.config file.

Explanation

As web.config is a configuration file for ASP.NET applications or ASP.NET web service applications to store data, it can be modified by the user after application setup using Notepad or programmatically. Most programmers use web.config as it stored data that can be changed dynamically by the user.

<appSettings>
  <add key="Name"  value="Keyvalue"/>
</appSettings>

A user might have to open and change this file many times if a web application or service is moved from one server to another frequently, so in the installer I've enabled a facility for a user to change the values of attributes of his choice.

My example in this application changes the connection string used by a web service.

<appSettings>
  <add key="Main.ConnectionString" 
        value="server=(local);database=DatabaseName;
               User ID=sa;Password=;
               trusted_connection=false"/>
</appSettings>

So in the installer, I change the key value by implementing the installer class in a webservice project.

Then in the installer class, I override the Install function:

public override void Install(IDictionary stateSaver)
{
    //You type here your own code
    CreateConnectionString();
    base.Install (stateSaver);
}

To get data required to change the values in web.config from the user, I add in the setup project, a custom action:

I the change custom data property for it to:

/Server=[EDITA1]@/Username=
      [EDITA2]@/Password=[EDITA3]@/Folder=[EDITA4]

[EDITA1], [EDITA2], [EDITA3], [EDITA4] are names of textboxes in the dialog added in the setup project interface.

You will notice the value here:

/Server=[EDITA1]@/Username=[EDITA2]@/Password=[EDITA3]@/Folder=[EDITA4]

I've separated the parameters to the Installer class by a special letter (@) to split them later as Visual Studio concatenates all the parameters to the first parameter and empty others.

void FormateParamters()
{
    string strServer,strUser , strPassword ,strFolder;
    EventLog.WriteEntry("TNT", Context.Parameters["Server"]);

    strServer=Context.Parameters["Server"].Split('@')[0];
    strUser=Context.Parameters["Server"].Split('@')[1];
    strPassword=Context.Parameters["Server"].Split('@')[2];
    strFolder=Context.Parameters["Server"].Split('@')[3];

    Context.Parameters["Server"]=strServer;
    Context.Parameters["Username"]=strUser.Split('=')[1];
    EventLog.WriteEntry("user",Context.Parameters["Username"]);

    Context.Parameters["Password"]=strPassword.Split('=')[1];
    EventLog.WriteEntry("Password",Context.Parameters["Password"]);

    Context.Parameters["Folder"]=strFolder.Split('=')[1];
    EventLog.WriteEntry("folder",Context.Parameters["Folder"]);

    EventLog.WriteEntry("Server",Context.Parameters["Server"]);
}

The previous function is to format the parameters by splitting them using the special character (@) so we can use them later for the connection string reconstruction function:

void CreateConnectionString()
{
    FormateParamters();

    Assembly ass=Assembly.GetExecutingAssembly();
    EventLog.WriteEntry ("Web.Config", 
             ass.GetName().Name+".Web.config");

    Stream stmConfig=ass.GetManifestResourceStream(
                   ass.GetName().Name+".Web.config");

    if(!Directory.Exists(Context.Parameters["Folder"]))
        Directory.CreateDirectory(Context.Parameters["Folder"]);

    FileStream stmPhysical=new FileStream(
        Context.Parameters["Folder"]+@"\Web.config",
        FileMode.Create);
    StreamReader srConfig=new StreamReader(stmConfig);
    StreamWriter swConfig=new StreamWriter(stmPhysical);

    string strConfig=srConfig.ReadToEnd();
    stmConfig.Close();
    strConfig=strConfig.Replace("server=(local);database" + 
              "=DatabaseName;User ID=sa;Password=;" + 
              "trusted_connection=false",NewConnection());


    swConfig.Write(strConfig);
    swConfig.Close ();
    stmPhysical.Close();

}

The above function copies the web.config from the physical path and begins to replace the old key value with the new value.

Note: the local folder parameter must be the same path where the webservice is installed in. In this case, it is:

C:\intpub\wwwroot\webtest1\

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Amal ElHosseiny
Web Developer
Egypt Egypt
No Biography provided

You may also be interested in...

Comments and Discussions

 
QuestionWeb.config edit Pin
kaushikpathak18-Oct-13 1:14
memberkaushikpathak18-Oct-13 1:14 
Questionhow to show the existing values in the textboxes before installation? Pin
Praveen Jeganathan22-Apr-13 1:58
memberPraveen Jeganathan22-Apr-13 1:58 
GeneralMy vote of 4 Pin
KiweenJain11-Nov-12 22:32
memberKiweenJain11-Nov-12 22:32 
GeneralCreate Web Service Installer Pin
Member 38889644-May-09 1:58
memberMember 38889644-May-09 1:58 
GeneralGreat article! Pin
Thomas ST21-Apr-09 4:02
memberThomas ST21-Apr-09 4:02 
GeneralPossible better way to acquire web.config path Pin
BillyGoatGruff8-Apr-09 6:22
memberBillyGoatGruff8-Apr-09 6:22 
GeneralRe: Possible better way to acquire web.config path [modified] Pin
Thomas ST21-Apr-09 3:57
memberThomas ST21-Apr-09 3:57 
QuestionModifing the Project for the Installer??? Pin
Ricardo Casquete3-Feb-08 17:16
memberRicardo Casquete3-Feb-08 17:16 
Generalproblem in installation Pin
chinni10000719-Sep-07 19:56
memberchinni10000719-Sep-07 19:56 
GeneralRe: problem in installation Pin
anand.lv16-Jan-09 3:26
memberanand.lv16-Jan-09 3:26 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

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

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.161208.2 | Last Updated 26 Jan 2006
Article Copyright 2006 by Amal ElHosseiny
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid