net中实际上已经为我们在这方面做得很好了。fcl中提供了不少的类来帮助我们完成这项工作,让我们的开发工作变非常简单和快乐。编程控制iis实际上很简单,和asp一样,.net中需要使用adsi来操作iis,但是此时我们不再需要getobject这个东东了,因为.net为我们提供了更加强大功能的新东东。
system.directoryservices命名空间中包括了些强大的东东–directoryentry,directoryentries,它们为我们提供了访问活动目录的强大功能,在这些类允许我们操作iis、ldap、nds以及winnt,功能很强大的吧:)
不过我们此处只谈iis的控制,一般来说,我们操作iis一般都是对虚拟目录的操作,因此我将此列为主要的内容来讲。
首先我们要搞清楚iis的层次结构的问题,下面是我从国外找来的一张图,很好的解释了iis的层次结构:
[htmchina:image id=image1|12][/htmchina:image]
为了搞清楚iis的控制语法,我们就必须搞清上图,了解iis元数据(metabase)的层次结构。图中的每一个节点称之key,而每个key可以包含一个或多个值,这些值就是我们说的属性(properties),iis元数据中的key与iis中的元素是相符的,因此元数据中的属性值的设定是会影响iis中的设置。这就是我们编程的基本思路和核心。
另外还要了解一下schema这个概念。它表示iis中构架的名称,即可以理解iis元数据中key的类型,具体点说就是指每个结点的类型。我们知道,iis中有虚拟目录,普通目录,以及文件这些东东,而这些都属于iis的元素,区分的他们的标帜就是schema。比如虚拟目录的schema就是"iisvirtualdir",普通目录就是"iiswebdir"。这样我们添加、删除目录时,iis就知道我们添加的是虚拟目录还是普通目录。
创建虚拟目录
directoryentry是.net给我们的一大礼物,他的名字我们就知道他的功能–目录入口。使用过adsi的人都知道操作iis,winnt这些时,我们还需要提供他们的path,操作iis时,这个path的格式为:
iis://computername/service/website/directory
computername:即操作的服务器的名字,可以是名字也可以是ip,经常用的就是localhost
service:即操作的服务器,iis中有web,也有ftp,还有smtp这些服务,我们主要是操作iis的web功能,因此此处就是"w3svc",如果是ftp则应是"msftpsvc"
website:一个iis服务中可以包括很多的站点,这个就用于设置操作的站点。他的值是一个数字,默认是1,表示缺省站点,如果有其它,则从1开始依次类推。
directory:不用说,即操作的目录名称,一个站点一般顶层目录为"root",其它目录则是他的孩子(child)。
首先我们获取一个站点的顶层目录(根目录):
directoryentry rootfolder = new directoryentry("iis://localhost/w3svc/1/root");
如果我们创建这个对象是没有发生异常,则表示这个目录是真实存在的。
下面我们来添加新的虚拟目录,比如我们要加的是"aspcn":
directoryentry newvirdir = rootfolder.children.add("aspcn","iiswebvirtualdir");
newvirdir.invoke("appcreate",true);
newvirdir.commitchanges();
rootfolder.commitchanges();
创建目录的思路很简单,即在根目录的子集(rootfolder.children)中再添加一条记录,这里使用的是directoryentries类中的add方法,它返回的是一个directoryentry,表示新加入的目录,第一个参数是虚拟目录的名字,第二个则是schema的类名以表明我们加入的目录类型。然后再使用directoryentry的invoke方法,调用adsi中的"appcreate"方法将目录真正创建(似乎不走这一步也可以创建目录成功,但是为了保险起见,大家还是用吧),最后便是依次调用新、根目录的commitchanges方法,确认此次操作。
在创建新目录时,我们也可以同时给这个目录的属性赋值,但是我的实战经验告诉我,最好不要这样做,如果创建时就赋值,将有很多属性不能赋值成功,比如重要的表示真实目录的path属性。因此飞刀建议大家最好是先创建目录,然后再赋值,即更新目录信息。
更新虚拟目录
相信大家对iis都比较熟悉,了解iis中一些重要的设置,如可读(accessread)、可写(accesswrite)、可执行(accessexecute)等。这些都可通过对directoryentry的properties属性集合的赋值来实现。赋值可以通过两种方式来完成:
第一种是调用properties集合的add方法,如:
dir.properties["accessread"].add(true);
第二种是对第一个索引值赋值:
dir.properties["accessread"][0] = true;
这两种方法都是可行的。具体是要看你的喜好了。
在进行赋值之前我们还是要确定要要赋值的目标吧:)这里我们使用directoryentries类的find方法,如:
directoryentry de = rootfolder.children.find("aspcn","iisvirtualdir");
找到了,我们就可以赋值了。赋值时一定要好好看看啊,虚拟目录的属性值可以超多,一查一大堆。。:(太多了,飞刀我也不重复了,大家去微软的站点上查:)
比较常用的有:accessread,accesswrite,accessexecute,accessscript,defaultdoc,enabledefaultdoc,path
删除虚拟目录
删除虚拟目录的方法也很简单,就是找到你要删除的虚拟目录,然后调用appdelete方法。
directoryentry de = rootfolder.children.find("aspcn","iisvirtualdir");
de.invoke("appdelete",true);
rootfolder.commitchanges();
还有一种方法,就是调用root目录的delete方法。
object[] paras = new object[2];
paras[0] = "iiswebvirtualdir"; //表示操作的是虚拟目录
paras[1] = "aspcn";
rootfolder.invoke("delete",paras);
rootfolder.commitchanges();
喜欢哪一种就看编程习惯了:))
.net中如何操作iis(源代码)
using system;
using system.data;
using system.directoryservices;
using system.collections;
namespace aspcn.management
{
/// <summary>
/// iismanager 的摘要说明。
/// </summary>
public class iismanager
{
//定义需要使用的
private string _server,_website;
private virtualdirectories _virdirs;
protected system.directoryservices.directoryentry rootfolder;
private bool _batchflag;
public iismanager()
{
//默认情况下使用localhost,即访问本地机
_server = "localhost";
_website = "1";
_batchflag = false;
}
public iismanager(string strserver)
{
_server = strserver;
_website = "1";
_batchflag = false;
}
/// <summary>
/// 定义公共属性
/// </summary>
//server属性定义访问机器的名字,可以是ip与计算名
public string server
{
get{ return _server;}
set{ _server = value;}
}
//website属性定义,为一数字,为方便,使用string
//一般来说第一台主机为1,第二台主机为2,依次类推
public string website
{
get{ return _website; }
set{ _website = value; }
}
//虚拟目录的名字
public virtualdirectories virdirs
{
get{ return _virdirs; }
set{ _virdirs = value;}
}
///<summary>
///定义公共方法
///</summary>
//连接服务器
public void connect()
{
connecttoserver();
}
//为方便重载
public void connect(string strserver)
{
_server = strserver;
connecttoserver();
}
//为方便重载
public void connect(string strserver,string strwebsite)
{
_server = strserver;
_website = strwebsite;
connecttoserver();
}
//判断是否存这个虚拟目录
public bool exists(string strvirdir)
{
return _virdirs.contains(strvirdir);
}
//添加一个虚拟目录
public void create(virtualdirectory newdir)
{
string strpath = "iis://" + _server + "/w3svc/" + _website + "/root/" + newdir.name;
if(!_virdirs.contains(newdir.name) || _batchflag )
{
try
{
//加入到root的children集合中去
directoryentry newvirdir = rootfolder.children.add(newdir.name,"iiswebvirtualdir";
newvirdir.invoke("appcreate",true);
newvirdir.commitchanges();
rootfolder.commitchanges();
//然后更新数据
updatedirinfo(newvirdir,newdir);
}
catch(exception ee)
{
throw new exception(ee.tostring());
}
}
else
{
throw new exception("this virtual directory is already exist.";
}
}
//得到一个虚拟目录
public virtualdirectory getvirdir(string strvirdir)
{
virtualdirectory tmp = null;
if(_virdirs.contains(strvirdir))
{
tmp = _virdirs.find(strvirdir);
((virtualdirectory)_virdirs[strvirdir]).flag = 2;
}
else
{
throw new exception("this virtual directory is not exists";
}
return tmp;
}
//更新一个虚拟目录
public void update(virtualdirectory dir)
{
//判断需要更改的虚拟目录是否存在
if(_virdirs.contains(dir.name))
{
directoryentry ode = rootfolder.children.find(dir.name,"iiswebvirtualdir";
updatedirinfo(ode,dir);
}
else
{
throw new exception("this virtual directory is not exists.";
}
}
//删除一个虚拟目录
public void delete(string strvirdir)
{
if(_virdirs.contains(strvirdir))
{
object[] paras = new object[2];
paras[0] = "iiswebvirtualdir"; //表示操作的是虚拟目录
paras[1] = strvirdir;
rootfolder.invoke("delete",paras);
rootfolder.commitchanges();
}
else
{
throw new exception("cant delete " + strvirdir + ",because it isnt exists.";
}
}
//批量更新
public void updatebatch()
{
batchupdate(_virdirs);
}
//重载一个:-)
public void updatebatch(virtualdirectories vds)
{
batchupdate(vds);
}
///<summary>
///私有方法
///</summary>
//连接服务器
private void connecttoserver()
{
string strpath = "iis://" + _server + "/w3svc/" + _website +"/root";
try
{
this.rootfolder = new directoryentry(strpath);
_virdirs = getvirdirs(this.rootfolder.children);
}
catch(exception e)
{
throw new exception("cant connect to the server ["+ _server +"] …",e);
}
}
//执行批量更新
private void batchupdate(virtualdirectories vds)
{
_batchflag = true;
foreach(object item in vds.values)
{
virtualdirectory vd = (virtualdirectory)item;
switch(vd.flag)
{
case 0:
break;
case 1:
create(vd);
break;
case 2:
update(vd);
break;
}
}
_batchflag = false;
}
//更新东东
private void updatedirinfo(directoryentry de,virtualdirectory vd)
{
de.properties["anonymoususername"][0] = vd.anonymoususername;
de.properties["anonymoususerpass"][0] = vd.anonymoususerpass;
de.properties["accessread"][0] = vd.accessread;
de.properties["accessexecute"][0] = vd.accessexecute;
de.properties["accesswrite"][0] = vd.accesswrite;
de.properties["authbasic"][0] = vd.authbasic;
de.properties["authntlm"][0] = vd.authntlm;
de.properties["contentindexed"][0] = vd.contentindexed;
de.properties["enabledefaultdoc"][0] = vd.enabledefaultdoc;
de.properties["enabledirbrowsing"][0] = vd.enabledirbrowsing;
de.properties["accessssl"][0] = vd.accessssl;
de.properties["accessscript"][0] = vd.accessscript;
de.properties["defaultdoc"][0] = vd.defaultdoc;
de.properties["path"][0] = vd.path;
de.commitchanges();
}
//获取虚拟目录集合
private virtualdirectories getvirdirs(directoryentries des)
{
virtualdirectories tmpdirs = new virtualdirectories();
foreach(directoryentry de in des)
{
if(de.schemaclassname == "iiswebvirtualdir"
{
virtualdirectory vd = new virtualdirectory();
vd.name = de.name;
vd.accessread = (bool)de.properties["accessread"][0];
vd.accessexecute = (bool)de.properties["accessexecute"][0];
vd.accesswrite = (bool)de.properties["accesswrite"][0];
vd.anonymoususername = (string)de.properties["anonymoususername"][0];
vd.anonymoususerpass = (string)de.properties["anonymoususername"][0];
vd.authbasic = (bool)de.properties["authbasic"][0];
vd.authntlm = (bool)de.properties["authntlm"][0];
vd.contentindexed = (bool)de.properties["contentindexed"][0];
vd.enabledefaultdoc = (bool)de.properties["enabledefaultdoc"][0];
vd.enabledirbrowsing = (bool)de.properties["enabledirbrowsing"][0];
vd.accessssl = (bool)de.properties["accessssl"][0];
vd.accessscript = (bool)de.properties["accessscript"][0];
vd.path = (string)de.properties["path"][0];
vd.flag = 0;
vd.defaultdoc = (string)de.properties["defaultdoc"][0];
tmpdirs.add(vd.name,vd);
}
}
return tmpdirs;
}
}
/// <summary>
/// virtualdirectory类
/// </summary>
public class virtualdirectory
{
private bool _read,_execute,_script,_ssl,_write,_authbasic,_authntlm,_indexed,_endirbrow,_endefaultdoc;
private string _ausername,_auserpass,_name,_path;
private int _flag;
private string _defaultdoc;
/// <summary>
/// 构造函数
/// </summary>
public virtualdirectory()
{
setvalue();
}
public virtualdirectory(string strvirdirname)
{
_name = strvirdirname;
setvalue();
}
private void setvalue()
{
_read = true;_execute = false;_script = false;_ssl= false;_write=false;_authbasic=false;_authntlm=false;
_indexed = false;_endirbrow=false;_endefaultdoc = false;
_flag = 1;
_defaultdoc = "default.htm,default.aspx,default.asp,index.htm";
_path = "c:\\";
_ausername = "";_auserpass ="";_name="";
}
///<summary>
///定义属性,iisvirtualdir太多属性了
///我只搞了比较重要的一些,其它的大伙需要的自个加吧。
///</summary>
public int flag
{
get{ return _flag;}
set{ _flag = value;}
}
public bool accessread
{
get{ return _read;}
set{ _read = value;}
}
public bool accesswrite
{
get{ return _write;}
set{ _write = value;}
}
public bool accessexecute
{
get{ return _execute;}
set{ _execute = value;}
}
public bool accessssl
{
get{ return _ssl;}
set{ _ssl = value;}
}
public bool accessscript
{
get{ return _script;}
set{ _script = value;}
}
public bool authbasic
{
get{ return _authbasic;}
set{ _authbasic = value;}
}
public bool authntlm
{
get{ return _authntlm;}
set{ _authntlm = value;}
}
public bool contentindexed
{
get{ return _indexed;}
set{ _indexed = value;}
}
public bool enabledirbrowsing
{
get{ return _endirbrow;}
set{ _endirbrow = value;}
}
public bool enabledefaultdoc
{
get{ return _endefaultdoc;}
set{ _endefaultdoc = value;}
}
public string name
{
get{ return _name;}
set{ _name = value;}
}
public string path
{
get{ return _path;}
set{ _path = value;}
}
public string defaultdoc
{
get{ return _defaultdoc;}
set{ _defaultdoc = value;}
}
public string anonymoususername
{
get{ return _ausername;}
set{ _ausername = value;}
}
public string anonymoususerpass
{
get{ return _auserpass;}
set{ _auserpass = value;}
}
}
/// <summary>
/// 集合virtualdirectories
/// </summary>
public class virtualdirectories : system.collections.hashtable
{
public virtualdirectories()
{
}
//添加新的方法
public virtualdirectory find(string strname)
{
return (virtualdirectory)this[strname];
}
}
}