.Net中如何操作IIS

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(源代码)

  1using System; 
  2using System.Data; 
  3using System.DirectoryServices; 
  4using System.Collections; 
  5namespace Aspcn.Management 
  6
  7/// <summary> 
  8/// IISManager 的摘要说明。 
  9/// </summary> 

 10public class IISManager 
 11
 12//定义需要使用的 
 13private string _server,_website; 
 14private VirtualDirectories _virdirs; 
 15protected System.DirectoryServices.DirectoryEntry rootfolder; 
 16private bool _batchflag; 
 17public IISManager() 
 18
 19//默认情况下使用localhost,即访问本地机 
 20_server = "localhost"
 21_website = "1"
 22_batchflag = false
 23}
 
 24public IISManager(string strServer) 
 25
 26_server = strServer; 
 27_website = "1"
 28_batchflag = false
 29}
 
 30/// <summary> 
 31/// 定义公共属性 
 32/// </summary> 

 33
 34//Server属性定义访问机器的名字,可以是IP与计算名 
 35public string Server 
 36
 37getreturn _server;} 
 38set{ _server = value;} 
 39}
 
 40//WebSite属性定义,为一数字,为方便,使用string 
 41//一般来说第一台主机为1,第二台主机为2,依次类推 
 42public string WebSite 
 43
 44getreturn _website; } 
 45set{ _website = value; } 
 46}
 
 47
 48//虚拟目录的名字 
 49public VirtualDirectories VirDirs 
 50
 51getreturn _virdirs; } 
 52set{ _virdirs = value;} 
 53}
 
 54///<summary> 
 55///定义公共方法 
 56///</summary> 

 57
 58//连接服务器 
 59public void Connect() 
 60
 61ConnectToServer(); 
 62}
 
 63//为方便重载 
 64public void Connect(string strServer) 
 65
 66_server = strServer; 
 67ConnectToServer(); 
 68}
 
 69//为方便重载 
 70public void Connect(string strServer,string strWebSite) 
 71
 72_server = strServer; 
 73_website = strWebSite; 
 74ConnectToServer(); 
 75}
 
 76//判断是否存这个虚拟目录 
 77public bool Exists(string strVirdir) 
 78
 79return _virdirs.Contains(strVirdir); 
 80}
 
 81//添加一个虚拟目录 
 82public void Create(VirtualDirectory newdir) 
 83
 84string strPath = "IIS://" + _server + "/W3SVC/" + _website + "/ROOT/" + newdir.Name; 
 85if(!_virdirs.Contains(newdir.Name) || _batchflag ) 
 86
 87try 
 88
 89//加入到ROOT的Children集合中去 
 90DirectoryEntry newVirDir = rootfolder.Children.Add(newdir.Name,"IIsWebVirtualDir"
 91newVirDir.Invoke("AppCreate",true); 
 92newVirDir.CommitChanges(); 
 93rootfolder.CommitChanges(); 
 94//然后更新数据 
 95UpdateDirInfo(newVirDir,newdir); 
 96}
 
 97catch(Exception ee) 
 98
 99throw new Exception(ee.ToString()); 
100}
 
101}
 
102else 
103
104throw new Exception("This virtual directory is already exist."
105}
 
106}
 
107//得到一个虚拟目录 
108public VirtualDirectory GetVirDir(string strVirdir) 
109
110VirtualDirectory tmp = null
111if(_virdirs.Contains(strVirdir)) 
112
113tmp = _virdirs.Find(strVirdir); 
114((VirtualDirectory)_virdirs[strVirdir]).flag = 2
115}
 
116else 
117
118throw new Exception("This virtual directory is not exists"
119}
 
120return tmp; 
121}
 
122
123//更新一个虚拟目录 
124public void Update(VirtualDirectory dir) 
125
126//判断需要更改的虚拟目录是否存在 
127if(_virdirs.Contains(dir.Name)) 
128
129DirectoryEntry ode = rootfolder.Children.Find(dir.Name,"IIsWebVirtualDir"
130UpdateDirInfo(ode,dir); 
131}
 
132else 
133
134throw new Exception("This virtual directory is not exists."
135}
 
136}
 
137  
138//删除一个虚拟目录 
139public void Delete(string strVirdir) 
140
141if(_virdirs.Contains(strVirdir)) 
142
143object[] paras = new object[2]; 
144paras[0= "IIsWebVirtualDir"//表示操作的是虚拟目录 
145paras[1= strVirdir; 
146rootfolder.Invoke("Delete",paras); 
147rootfolder.CommitChanges(); 
148}
 
149else 
150
151throw new Exception("Can''t delete " + strVirdir + ",because it isn''t exists."
152}
 
153}
 
154//批量更新 
155public void UpdateBatch() 
156
157BatchUpdate(_virdirs); 
158}
 
159//重载一个:-) 
160public void UpdateBatch(VirtualDirectories vds) 
161
162BatchUpdate(vds); 
163}
 
164  
165///<summary> 
166///私有方法 
167///</summary> 

168
169//连接服务器 
170private void ConnectToServer() 
171
172string strPath = "IIS://" + _server + "/W3SVC/" + _website +"/ROOT"
173try 
174
175this.rootfolder = new DirectoryEntry(strPath); 
176_virdirs = GetVirDirs(this.rootfolder.Children); 
177}
 
178catch(Exception e) 
179
180throw new Exception("Can''t connect to the server ["+ _server +"",e); 
181}
 
182}
 
183//执行批量更新 
184private void BatchUpdate(VirtualDirectories vds) 
185
186_batchflag = true
187foreach(object item in vds.Values) 
188
189VirtualDirectory vd = (VirtualDirectory)item; 
190switch(vd.flag) 
191
192case 0
193break
194case 1
195Create(vd); 
196break
197case 2
198Update(vd); 
199break
200}
 
201}
 
202_batchflag = false
203}
 
204//更新东东 
205private void UpdateDirInfo(DirectoryEntry de,VirtualDirectory vd) 
206
207de.Properties["AnonymousUserName"][0= vd.AnonymousUserName; 
208de.Properties["AnonymousUserPass"][0= vd.AnonymousUserPass; 
209de.Properties["AccessRead"][0= vd.AccessRead; 
210de.Properties["AccessExecute"][0= vd.AccessExecute; 
211de.Properties["AccessWrite"][0= vd.AccessWrite; 
212de.Properties["AuthBasic"][0= vd.AuthBasic; 
213de.Properties["AuthNTLM"][0= vd.AuthNTLM; 
214de.Properties["ContentIndexed"][0= vd.ContentIndexed; 
215de.Properties["EnableDefaultDoc"][0= vd.EnableDefaultDoc; 
216de.Properties["EnableDirBrowsing"][0= vd.EnableDirBrowsing; 
217de.Properties["AccessSSL"][0= vd.AccessSSL; 
218de.Properties["AccessScript"][0= vd.AccessScript; 
219de.Properties["DefaultDoc"][0= vd.DefaultDoc; 
220de.Properties["Path"][0= vd.Path; 
221de.CommitChanges(); 
222}
 
223
224//获取虚拟目录集合 
225private VirtualDirectories GetVirDirs(DirectoryEntries des) 
226
227VirtualDirectories tmpdirs = new VirtualDirectories(); 
228foreach(DirectoryEntry de in des) 
229
230if(de.SchemaClassName == "IIsWebVirtualDir" 
231
232VirtualDirectory vd = new VirtualDirectory(); 
233vd.Name = de.Name; 
234vd.AccessRead = (bool)de.Properties["AccessRead"][0]; 
235vd.AccessExecute = (bool)de.Properties["AccessExecute"][0]; 
236vd.AccessWrite = (bool)de.Properties["AccessWrite"][0]; 
237vd.AnonymousUserName = (string)de.Properties["AnonymousUserName"][0]; 
238vd.AnonymousUserPass = (string)de.Properties["AnonymousUserName"][0]; 
239vd.AuthBasic = (bool)de.Properties["AuthBasic"][0]; 
240vd.AuthNTLM = (bool)de.Properties["AuthNTLM"][0]; 
241vd.ContentIndexed = (bool)de.Properties["ContentIndexed"][0]; 
242vd.EnableDefaultDoc = (bool)de.Properties["EnableDefaultDoc"][0]; 
243vd.EnableDirBrowsing = (bool)de.Properties["EnableDirBrowsing"][0]; 
244vd.AccessSSL = (bool)de.Properties["AccessSSL"][0]; 
245vd.AccessScript = (bool)de.Properties["AccessScript"][0]; 
246vd.Path = (string)de.Properties["Path"][0]; 
247vd.flag = 0
248vd.DefaultDoc = (string)de.Properties["DefaultDoc"][0]; 
249tmpdirs.Add(vd.Name,vd); 
250}
 
251}
 
252return tmpdirs; 
253}
 
254
255}
 
256/// <summary> 
257/// VirtualDirectory类 
258/// </summary> 

259public class VirtualDirectory 
260
261private bool _read,_execute,_script,_ssl,_write,_authbasic,_authntlm,_indexed,_endirbrow,_endefaultdoc; 
262private string _ausername,_auserpass,_name,_path; 
263private int _flag; 
264private string _defaultdoc; 
265/// <summary> 
266/// 构造函数 
267/// </summary> 

268public VirtualDirectory() 
269
270SetValue(); 
271}
 
272public VirtualDirectory(string strVirDirName) 
273
274_name = strVirDirName; 
275SetValue(); 
276}
 
277private void SetValue() 
278
279_read = true;_execute = false;_script = false;_ssl= false;_write=false;_authbasic=false;_authntlm=false
280_indexed = false;_endirbrow=false;_endefaultdoc = false
281_flag = 1
282_defaultdoc = "default.htm,default.aspx,default.asp,index.htm"
283_path = "C:\\"
284_ausername = "";_auserpass ="";_name=""
285}
 
286///<summary> 
287///定义属性,IISVirtualDir太多属性了 
288///我只搞了比较重要的一些,其它的大伙需要的自个加吧。 
289///</summary> 

290
291public int flag 
292
293getreturn _flag;} 
294set{ _flag = value;} 
295}
 
296public bool AccessRead 
297
298getreturn _read;} 
299set{ _read = value;} 
300}
 
301public bool AccessWrite 
302
303getreturn _write;} 
304set{ _write = value;} 
305}
 
306public bool AccessExecute 
307
308getreturn _execute;} 
309set{ _execute = value;} 
310}
 
311public bool AccessSSL 
312
313getreturn _ssl;} 
314set{ _ssl = value;} 
315}
 
316public bool AccessScript 
317
318getreturn _script;} 
319set{ _script = value;} 
320}
 
321public bool AuthBasic 
322
323getreturn _authbasic;} 
324set{ _authbasic = value;} 
325}
 
326public bool AuthNTLM 
327
328getreturn _authntlm;} 
329set{ _authntlm = value;} 
330}
 
331public bool ContentIndexed 
332
333getreturn _indexed;} 
334set{ _indexed = value;} 
335}
 
336public bool EnableDirBrowsing 
337
338getreturn _endirbrow;} 
339set{ _endirbrow = value;} 
340}
 
341public bool EnableDefaultDoc 
342
343getreturn _endefaultdoc;} 
344set{ _endefaultdoc = value;} 
345}
 
346public string Name 
347
348getreturn _name;} 
349set{ _name = value;} 
350}
 
351public string Path 
352
353getreturn _path;} 
354set{ _path = value;} 
355}
 
356public string DefaultDoc 
357
358getreturn _defaultdoc;} 
359set{ _defaultdoc = value;} 
360}
 
361public string AnonymousUserName 
362
363getreturn _ausername;} 
364set{ _ausername = value;} 
365}
 
366public string AnonymousUserPass 
367
368getreturn _auserpass;} 
369set{ _auserpass = value;} 
370}
 
371}
 
372/// <summary> 
373/// 集合VirtualDirectories 
374/// </summary> 

375
376public class VirtualDirectories : System.Collections.Hashtable 
377
378public VirtualDirectories() 
379
380}
 
381//添加新的方法 
382public VirtualDirectory Find(string strName) 
383
384return (VirtualDirectory)this[strName]; 
385}
 
386}
 
387}
 
388
posted @ 2005-08-16 13:05  James.Ying  阅读(1094)  评论(0编辑  收藏  举报