1. 使用该类SPDocumentLibrary来实现一些对文档库的操作,文档库只是列表的一种特殊类型,所以当我们使用如下代码的时候,显示出的list是包括文档库的。
SPWeb site = SPContext.Current.Web;
foreach (SPList list in site.Lists)
{
// 所有的列表,当然也包括文档库
}
2. 文档库和列表的主要不同点是文档库是用来存储文档的,SPDocumentLibrary类是继承自SPList的,所以当你获得SPList对象的时候就可以判断该列表是否为文档库
public bool IsListAlsoDocumentLibrary(SPList list)
{
if(list is SPDocumentLibrary)
return true;
else
return false;
}
3. 站点可能有很多隐藏的文档库,比如webpart库,站点模板库,母板页库,我们可以把他们显示在一个DropDownList中,代码如下:
SPWeb site = SPContext.Current.Web;
foreach (SPList list in site.Lists)
{
if(list is SPDocumentLibrary && !list.Hidden)
{
SPDocumentLibrary docLib = (SPDocumentLibrary)list;
lstTargetLibrary.Items.Add(new ListItem(docLib.Title, docLib.ID.ToString()));
}
}
4.1 由于文档库在wss的object model中也是SPList,所以每一个文档也是一个SPlistItem对象,然而在文档库中的文档
也可以为一个SPFile对象,所以我们可以通过这两种方法是操作。
void ProcessDocuments(SPDocumentLibrary docLib) { foreach(SPListItem item in docLib.Items) { // 操作SPListItem对象 SPFile file = item.File; // 操作SPFile 对象 } }
4.2 SPListItem对象记录了一个文档的ID,对栏元数据的读写,如下代码:
foreach (SPListItem item in docLib.Items)
{
int itemID = item.ID; // 读元数据栏信息
string clientColumnValue = item["Client"].ToString();
//写元数据栏信息
item["Client"] = "AdventureWorks";
item.Update();
}
4.3 SPFile一般来控制文档的内容,比如下面代码:
foreach (SPListItem item in docLib.Items)
{
if(item.FileSystemObjectType == SPFileSystemObjectType.File)
{
SPFile file = item.File;
int versionCount = file.Versions.Count;
// 是否被签出
DateTime checkedOutDate = file.CheckedOutDate;
// 基于流的方式打开处理
using(Stream fileContents = file.OpenBinaryStream())
{}
}
}
5. 这里需要注意的是如果文档库中有文件夹的时候,对应object model为一个内容为SPListItem的Items的集合,所以上面的代码中我在把SPListItem转换为SPFile前来判断SPFileSystemObjectType属性。
如果你仅仅想把站点中文档库都列举出来,你还可以通过如下方法:
void ProcessDocumentsAtRoot(SPDocumentLibrary docLib)
{
foreach (SPFile file in docLib.RootFolder.Files)
{
// program against file using SPFile class
}
}
6.1 添加一个新的文件到文档库中,下面是主要代码:
protected void CreateDocument()
{
SPSite siteCollection = SPContext.Current.Site;
SPWeb site = SPContext.Current.Web;
Guid libraryID = new Guid(lstTargetLibrary.SelectedValue);
SPDocumentLibrary library = (SPDocumentLibrary)site.Lists[libraryID];
string documentName = txtFileName.Text;
string libraryRelativePath = library.RootFolder.ServerRelativeUrl;
string libraryPath = siteCollection.MakeFullUrl(libraryRelativePath);
string documentPath = libraryPath + "/" + documentName;
Stream documentStream = new MemoryStream();
StreamWriter writer = new StreamWriter(documentStream);
writer.Write(txtDocumentBody.Text);
writer.Flush();
Hashtable docProperties = new Hashtable();
docProperties["vti_title"] = "This is a test title";
docProperties["Color"] = "Green";
site.Files.Add(documentPath, documentStream, docProperties, true);
Response.Redirect(libraryPath);
}
6.2 使用上面代码创建的文档,我们只是指定了"vti_title"和"Color"两个元数据的信息,wss默认为我们生成了许多,我们可以通过下面的代码来查看系统到底为我们做了什么?
SPList list = site.Lists["CaryPro"];
foreach (SPListItem item in list.Items)
{
SPFile file = item.File;
foreach (DictionaryEntry entry in file.Properties)
{
Console.WriteLine(entry.Key + ":" + entry.Value);
}
break;
}
7 使用Feature创建新的文档库实例
7.1 你可以使用网站设置中的UI,也可以自定义一个基于某个内容类型的文档库,我们可以Feature方式提供某个标准文档库的实例,如下设置:
<ListInstance
FeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101"
TemplateType="101"
Id="CaryPro"
Description="Document Library for CaryPro"
OnQuickLaunch="True"
Title="CaryPro"
Url="CaryPro"
>
</ListInstance>
FeatureId必须是个GUID,TemplateType需要为文档库的类型,就是101
7.2 下面的配置为,在TestData目录有相应的文档,这些文档会默认就放到该文档库中
<Module Name="TestData" List="101" Path="TestData" Url="CaryPro" >
<File Url="AdventureCaryPro.docx" Type="GhostableInLibrary" />
<File Url="ContosoCaryPro.docx" Type="GhostableInLibrary" />
<File Url="WingtipCaryPro.docx" Type="GhostableInLibrary" />
</Module>
7.3 设置默认的文档库模板
<Module Name="WordTemplate" List="101" Url="CaryPro/Forms">
<File Url="CaryProTemplate.dotx" Type="GhostableInLibrary" />
</Module>
7.4 FeatureActivated中创建文档库
public override void FeatureActivated(SPFeatureReceiverProperties properties)
{
SPWeb site = (SPWeb)properties.Feature.Parent;
SPDocumentLibrary libProposals = (SPDocumentLibrary)site.Lists["CaryPro"];
string templateUrl = @"CaryPro/Forms/CaryProTemplate.dotx";
libProposals.DocumentTemplateUrl = templateUrl;
libProposals.Update();
}
本文转自:http://www.cnblogs.com/carysun/archive/2008/07/05/DocumentLibrary.html