C#操作Kentico cms

C#操作Kentico cms 中的 content(winform环境)

前段时间做了个winform程序,去管理kentico网站的content,包括content节点的增删改查,以及相应节点内容的修改。现在将对content的操作方法简单的介绍一下。

我们想要操作kentico网站的content(如下图),操作步骤如下。

C#操作Kentico cms

一、引入kentico相关的dll文件,配置数据库链接环境

不直接使用sql查询语句去操作,而是使用kentico cms的方法去直接操作,我们需要引入kentico cms系统中的dll文件,这些文件在kentico cms网站的/bin目录下面可以找到,就是一些前缀是CMS.的文件,如下图,下图只是一部分:

C#操作Kentico cms

接下来就是需要在配置数据库连接,在app.config中添加配置代码如下:

1 <connectionStrings>
2 <add name="CMSConnectionString" connectionString="Persist Security Info=False;database=expert_fi_7;server=.\SQLEXPRESS;user id=sa;password=******;Current Language=English;Connection Timeout=240;" />
3 </connectionStrings>

该配置连接的name必须为CMSConnectionString,这样才能有cms类库自动的识别。

二、初始化kentico CMS环境

引入命名空间:using CMS.CMSHelper

在需要使用content操作的代码前加上

1 CMSContext.Init();

三、操作content节点

对节点的操作无非就是增、删、改、查这几种操作,下面一一介绍

  • 查询操作
    C#操作Kentico cms
     1 TreeProvider tree = new TreeProvider(CMSContext.CurrentUser);//获取当前content树对象
    2
    3 var node = tree.SelectSingleNode(CMSContext.CurrentSiteName
    4 , "/Tuotteet" //该处为Alias path,见下图
    5 , "en-us",true); //获取节点Tuotteet
    6
    7 value = node.GetValue(columnNames["propertyName"]).ToString(); //获取某一属性值
    8 //【注】该node不能直接用node.Children去获取,node.Children获取的只是最基本的信息
    9
    10 //获取指定节点所有属性名
    11 DataClassInfo dci = DataClassInfoProvider.GetDataClass(node.NodeClassName);
    12 var columnNames=new List<string>(); //创建属性名对象
    13 if (dci != null)
    14 {
    15 CMS.FormEngine.FormInfo fi = new CMS.FormEngine.FormInfo(dci.ClassFormDefinition);
    16 columnNames = fi.GetColumnNames();
    17 }
    18
    19 //获取所有子节点
    20 var childrenNodes=node.Children
    C#操作Kentico cms

    如果你想获取所有子节点的属性,你可以遍历childrenNodes,然后使用SelectSingleNode(……)的方法去获取指定子节点的对象,然后去获取它的属性。
    对于上面提到的Alias path,见下图示例:C#操作Kentico cms

  • 添加节点
    C#操作Kentico cms
     1         public void AddNode(string nodeAliasPath,List<string[]> categorys )
    2 {
    3 var parentNodeAliasPath = nodeAliasPath.Substring(0, nodeAliasPath.LastIndexOf('/'));
    4 var tree = new TreeProvider(CMSContext.CurrentUser);
    5 var parentNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, parentNodeAliasPath, "fi-FI", true);
    6 var className = categorys[1][1];
    7 TreeNode newNode = TreeNode.New(className, tree);
    8 newNode.DocumentName = categorys[1][0];//设置节点名
    9 newNode.DocumentCulture = "fi-FI";//设置节点的document环境
    10 for (int i = 2; i < categorys[0].Length - 2; i++)
    11 {
    12 newNode.SetValue(categorys[0][i], categorys[1][i]);//为节点添加新的属性,SetValue(属性名,值)
    13 }
    14 DocumentHelper.InsertDocument(newNode, parentNode, tree);
    15 }
    C#操作Kentico cms

    这里要注意的是必须给节点新节点添加属性,不然该节点在添加后不会显示出来

  • 删除节点
    C#操作Kentico cms
    1         public void DeleteNode(string nodeAliasPath)
    2 {
    3 var tree = new TreeProvider(CMSContext.CurrentUser);
    4 var deleteNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, nodeAliasPath, "fi-FI", true);
    5 if (deleteNode != null)
    6 {
    7 DocumentHelper.DeleteDocument(deleteNode, tree, true, true, true);
    8 }
    9 }
    C#操作Kentico cms

    关于DeleteDocument的说明,如下图
    C#操作Kentico cms

  • 修改节点内容
    C#操作Kentico cms
     1         public void UpdateNode(string nodeAliasPath,List<string[]> categorys )
    2 {
    3 var tree = new TreeProvider(CMSContext.CurrentUser);
    4 var updateNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, nodeAliasPath, "fi-FI", true);
    5 updateNode.DocumentName = categorys[1][0];
    6 for (int i = 1; i < categorys[0].Length-1;i++ )
    7 {
    8 updateNode.SetValue(categorys[0][i], categorys[1][i]);
    9 }
    10 DocumentHelper.UpdateDocument(updateNode, tree);
    11 }
    C#操作Kentico cms

    当然,还有很多节点的属性你可以修改,例子代码没有列出来。

就以上的这些内容,基本可以去简单操作kentico cms中的content内容了,欢迎大家讨论。

参考:http://devnet.kentico.com/Documentation.aspx

珍惜作者劳动成果,如须转载,请说明出处。

 
 
分类: 开发经验Kentico
标签: kentico cmscontent
上一篇:nefu 449 超级楼梯 &&nefu 911 跨楼梯


下一篇:Headless Chrome:服务端渲染JS站点的一个方案【上篇】【翻译】