SharePoint类库简要总结

System.Web.UI.WebControls.WebParts; 为WebPart类的所在。

控件有： Button , TextBox , HtmlTableCell , Labe

它的公共属性有 :
AllowMinimize : 是否允许最小化;
Caption : WebPart的说明,标题后面的文字;
Description : WebPart的简介;
FrameState : WebPart的状态, Minimized 或 Normal ;
FrameType : WebPart边框的类型，有以下几种，Default(默认，使用该WebPart所在WebPartZone设定),None,Standard,TitleBarOnly(有标题栏无边框)
Height/Width : webPart 的长度和宽度；
ID : WebPart的ID；
PartImageLarge/PartImageSmall : WebPart的图片，通过设置这个图片，可以在管理WebPart时方便地找到该WebPart,与其他WebPart区分开；
Title : WebPart的标题;
ZoneID : WebPart 所在WebPartZone 的ID；

WebPart还有一些公有的或protected 函数 ,
Controls.Add( "控件对象" ) 在WebPart上添入控件。

protected 成员：
protected override void Render( System.Web.UI.HtmlTextWriter writer) //默认行为是依次遍历Controls中的控件,并将他们输出。
protected override void OnLoad( EventArgs e ) //首次加载时处理的事件
protected override void CreateChildControls() //由 Asp.net 页面框架调用 , 以通知服务器控件创建他们包含的任何子控件，以便回发或呈现做准备。

Microsoft.SharePoint;
//该命名提供了WSS中关于网站内容的基本的对象模型，例如网站，列表，文件和用户等。

SPSite 类

//网站的集合

构造函数： SPSite( String url ) ，SPSite( Guid x )

//Guid是对象的唯一标识符，通过Guid可以获取该对象实例，例如 SPSite , SPWeb , SPList , SPView , Area , AreaListing
//有些还采用整数做标识符，例如表项SPListItem , 角色SPRole , 用户SPUser

AllWebs 属性
//可以获取该网站集中的所有网站，包括一个顶级网站和它下面的所有子网站。
//并且可以通过 webs[ int index ] , webs[ String url ] , webs[ Guid guid ] ,获得特定的SPWeb对象。

RootWeb 属性
//该属性是个SPWeb类型变量，它对所对应的对象是该网站集中的顶级网站，通过它可以逐步获得该网站级中的层级结构。

OpenWeb 函数
//返回一个SPWeb类型变量，通过该函数可以获得网站集中一个特定的网站。
OpenWeb( );
OpenWeb( Guid guid );
OpenWeb( String url );

SPWeb 类

//网页内容集合

//大多数和WSS相关的内容都是通过使用SPWeb的一些成员变量来获取的，这些成员主要有：

AllUsers : 网站所有成员，以及通过域组来浏览网站的用户；
Files : 网站下的所有文件；
Folders : 网站下的所有目录；
Groups : 所有跨网站用户组；
Lists : 网站下的所有列表；
ListTemplates : 网站下的所有列表模版；
Permissions : 网站下的权限；
Roles : 网站下的所有角色；
Users : 属于该网站的所有用户；
Webs : 该网站的所有子网站；

//此外，SPWeb一些成员变量对应于网站的一些属性，例如：
AllowAnonymousAccess : 网站是否允许匿名访问(只读)；
Author : 网站的创建者；
Created : 网站的创建时间；
CurrentUser : 当前的用户；
ID : 唯一标识该网站的Guid；
IsRootWeb : 该网站是否为顶级网站；
ParentWeb : 该网站的父网站；
Site : 该网站所属的网站集；
Title : 该网站的标题；
Url : 该网站的url绝对路径；
WebTemplate : 该网站的模版；

//SPWeb 对象提供的一些方法
GetFile : 通过url获得一个文件的对象(SPFile);
GetFolder : 通过url获取一个目录的对象SPFolder;
GetListOfType : 获取特定类型的列表的集合；
GetSubwebsForCurrentUser : 获取该网站的子网站(可以指定模板)；
GetViewFromUrl : 通过url获取一个列表的视图SPView;
SaveAsTemplate : 将网站保存为模板;
SearchDocuments : 搜索网站的文档库(需要开启全文检索功能);
SearchListItems : 搜索列表条目；
Update : 使网站属性的修改生效；
//在修改对象属性时，只有Update后才会生效

SPList 类

//列表功能类
//获取SPList的主要方法是通过访问 SPWeb.lists 这一 SPListCollection类型的属性。
//从该集合获得一个特定的列表对象有如下3种方法：
lists[ String name ];
lists[ Guid guid ];
lists[ int index ];

//添加一个列表通过调用SPListCollection.Add方法来完成，创建成功后返回新列表的Guid。
Add( String tile , String description , SPListTemplate template );
//前两个参数分别指定列表的名称和简介，第3个参数是一个SPListTemplate型变量，
//指定该列表创建时所需要的列表模板对象，该对象可以用SPWeb.ListTemplates属性获得;

Add( String title , String description , SPListTemplateType type );
//第3个参数是SPListTemplateType型枚举指定列表模板，枚举中所包含的都是
//网站默认拥有的基本类型的列表模板，如果创建一个自定义列表，可以用 SPListTemplateType.GenericList 做为该参数;

Add( String title , String description , SPListTemplate template , SPDocTemplate docTemplate );
//该方法会创建一个文档库,第3个参数指定列表的模板对象，第4个参数指定文档库的对象，
//该对象可以通过SPWeb.DocTemplates属性获得；

//删除列表时，通过调用SPListCollection.Delete 方法完成
Delete( Guid guid );//通过Guid来删除列表

//SPlist 有如下一些常用属性：
BaseTemplate : 该列表所对应的列表模板；
BaseType : 该列表的基础类型；
DefaultView : 该列表的默认视图对象；
EnableAttachments : 该列表是否允许添加附件；
EnableModeration : 该列表是否开启审批功能；
Fields : 列表字段的集合;
Forms : 列表表单的集合，主要有浏览，添加和修改几个页面；
ID : 标适该列表的唯一的Guid；
Items : 列表条目的集合；
ParentWeb : 列表所在的网站对象；
Title : 列表的标题；
Views : 该列表的视图的集合；
//修改属性后要通过 SPList.Update 方法使修改生效.

SPView 类

//视图除了负责数据的多样化显示，视图的另外一个重要作用就是对数据的筛选和排序
//在SharePoint环境中可以直接对视图的这些内容方便地进行修改，通过使用计算字段，可以更加丰富筛选和排序功能；

//获取SPView 对象有3种方法：
通过List.DefaultView 属性得到该列表的默认视图；
通过SPWeb.GetViewFromUrl 方法根据url获取到该视图，在实际使用中，可以使用这种方法先获得一个视图，再得到这个视图所在的列表对象；
通过List.Views 得到该列表的所有视图，再通过以下3种方式得到特定的视图：
    views[ String name ];
    views[ Guid guid ];
    views[ int index ];

//添加一个视图，通过SPViewCollection.Add方法来完成：
Add( String name , StringCollection fields , String query , uint rowLimit , bool paged , bool makeDefault);
//name参数指定视图名称， fields参数指定了需要显示的字段名的集合，
//query参数指定了对数据的筛选条件，rowLimit参数指定了视图中一次所返回的列表条目的最大个数，
//paged参数指定了该视图是否支持翻页， makeDefault 参数指定了是否需要将该视图作为默认视图；

Add( String name , StringCollcection fields , String query , uint rowLimit , bool paged , bool makeDefault, SPViewCollection.SPViewType type , bool personalView);
//前面参数与上文相同，type参数指定了该视图的基本类型，personalView参数指定了该视图是否为个人视图。

//与列表添加方法不同，试图添加方法返回的是 SPview对象，而不是一个Guid;
//删除一个视图同样使用SPViewCollection.Delete 方法，用视图的Guid作为参数；
//默认页面浏览一个视图的时候，视图的翻页功能只有"下一页"而没有"上一页",如果需要实现向前翻页功能，需要自己写程序完成；

//SPView 中常用的一些属性如下：
ID : 标识该视图的列表对象(SPList);
ParentList : 包含该视图的列表对象；
PropertiesXml : 该视图的基本信息，包括URL，名称和类型等；
Query : 视图中对数据进行筛选的查询XML字符串；
SchemaXml : 该视图的信息，包括基本信息和例如筛选，分组等；
Title : 该视图的名称；
ViewFields : 该视图需要显示的字段的集合；
Url : 显示该视图所对应的URL；
//修改属性后需要调用SPView.Update 才能使修改生效

SPField 类

//对应于列表中的字段对象。SharePoint的列表由若干个字段所组成，每个字段可以设置为不同的数据类型，也可以拥有不同的属性设置,例如默认值，是否隐藏，是否可以为空等。

//获得SPField对象方法主要是通过SPList.Fields 属性得到所有字段，再通过两种方法得到特定字段：
fields[ String dispName ];
fields[ int index ];

//为列表添加字段有3种方法：
Add( String dispName , SPFieldType type , bool bRequired );
AddLookup( String dispName , Guid lookupListID , bool bRequired );
AddFieldAsXml( String strXml);

//SPField 拥有如下一些比较常用的属性。
DefaultFormula : 计算字段的公式;
DefaultValue : 字段的默认值；
Description : 该字段的说明描述信息；
Filterable : 该字段是否可以被筛选;
Hidden : 该字段是否在列表中显示；
InernalName : 该字段的内部名称；
ParentList : 该字段所在列表的对象；
ReadOnlyField : 该字段是否被只读；
Required : 在填写数据时候，该字段是否必填;
SchemaXml : 该字段设置的信息；
Sortable : 该字段是否可以被排序；
Title : 该字段的字段名，即显示名称；
Type : 该字段的类型，为SPFieldType 类型的枚举;
//修改后用Update更新才会生效；
//每个字段都有两个名称，即显示名称和内部名称，它们在对象模型中对应于 SPField.Title 和 SPField.InternalName 。
//SPField的子类有，SPFieldText , SPFieldLookup , SPFieldNumber.

SPListItem 类

//在列表的实际操作中，最终要接触到的还是作为数据内容部分的列表条目(List Item).
//在访问列表的某个具体条目之前，都需要先获得一个列表条目的集合。
//获得列表条目集合的方法：
使用SPList.Items 属性，该属性返回列表中的所有列表条目，在需要得到或者遍历所有列表条目时，可以使用这种获取列表的方法；
使用SPList.GetItems 方法，有目的的获得部分列表条目：
   GetItems( SPView view );
   GetItems( SPQuery query );//SPQuery 是负责查询列表条目的一个类，通过定义一个查询，可以方便地获取想要得到的列表条目；
   //SPQuery提供了两种构造函数，一种是无参数的，另外一种可以带有一个SPView类型的参数，即在指定的视图上进行2次查找。
   //SPQuery最核心的一个属性就是Query属性，它是一个字符串的类型，它通过一种特殊定义过的xml形式，即 CAML( Collaborative Application Markup Language )
   //的形式描述一个查询的条件，实际上这个查询字符串和 SPView.Query 属性是相当的。
   GetItems( SPQuery query , String viewID );

//在使用SPQuery 时，必须每使用一次都要重新进行构造( 即使用new 运算符重新生成一个新的对象)，然后再指定Query属性；
//否则，如果不进行重新构造，即使指定了不同的Query 属性，在每次查询的时候始终得到的是第一次指定的Query 条件的查询结果。

//获得集合后，在获得某个具体的列表条目时，有下面两种方法。
items[ int index ];
GetItemById( int id );//每个列表条目都会有一个该列表中唯一的ID

//得到列表条目之后，就可以对该条目的内容进行访问或修改了，访问条目某个字段方法最常用的为: item[ String fieldname ]
//其中 fieldname ，可以使用该字段的显示名称，也可以使用该字段的内部名称。

//SPListItem属性
Attachments :该列表条目的附件集合;
File : 如果该列表是文档库的话，得到该文件的对象；
ID : 在该列表唯一标识该列表条目的整型；
ModerationInfomation : 该列表条目的审批信息；
ParentList : 该列表条目所在列表对象；
Xml : 以XML的格式返回该列表条目中的所有数据；
//属性修改后，通过SPListItem.Update使得修改生效;

//添加一条列表条目方法
SPListItemCollection.Add()
//该方法不需要参数，直接返回一个空的SPListItem对象，
//通过该对象对各字段的内容进行修改，再调用Update就可将该条目添加到该列表中。

//删除一个列表条目
SPListItemCollection.DeleteById( int id );
SPListItemCollection.Delete( int index );

//SPListItemCollection 类中，有一个非常有用的方法：GetDataTable 即
DataTable GetDataTable();
//该方法可以返回由这些列表条目所组成的DataTable对象，以便将数据绑定到一些显示控件上。而没有条目时返回NULL；