C#操作Kentico cms 中的 content（winform环境）

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

我们想要操作kentico网站的content（如下图），操作步骤如下。

 

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

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

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

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

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

 

二、初始化kentico CMS环境

引入命名空间：using CMS.CMSHelper

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

CMSContext.Init();

 

三、操作content节点

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

• 查询操作

  TreeProvider tree = new TreeProvider(CMSContext.CurrentUser);//获取当前content树对象
  
   var node = tree.SelectSingleNode(CMSContext.CurrentSiteName
  , "/Tuotteet"     //该处为Alias path,见下图
  , "en-us",true);   //获取节点Tuotteet
  
  value = node.GetValue(columnNames["propertyName"]).ToString();  //获取某一属性值
  //【注】该node不能直接用node.Children去获取，node.Children获取的只是最基本的信息
  
  //获取指定节点所有属性名
  DataClassInfo dci = DataClassInfoProvider.GetDataClass(node.NodeClassName);
  var columnNames=new List<string>();  //创建属性名对象
  if (dci != null)
  {
        CMS.FormEngine.FormInfo fi = new CMS.FormEngine.FormInfo(dci.ClassFormDefinition);
        columnNames = fi.GetColumnNames();
  }
  
  //获取所有子节点
  var childrenNodes=node.Children

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

• 添加节点

          public void AddNode(string nodeAliasPath,List<string[]> categorys )
          {
              var parentNodeAliasPath = nodeAliasPath.Substring(0, nodeAliasPath.LastIndexOf('/'));
              var tree = new TreeProvider(CMSContext.CurrentUser);
              var parentNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, parentNodeAliasPath, "fi-FI", true);
              var className = categorys[1][1];
              TreeNode newNode = TreeNode.New(className, tree);
              newNode.DocumentName = categorys[1][0];//设置节点名
              newNode.DocumentCulture = "fi-FI";//设置节点的document环境
              for (int i = 2; i < categorys[0].Length - 2; i++)
              {
                  newNode.SetValue(categorys[0][i], categorys[1][i]);//为节点添加新的属性，SetValue(属性名，值)
              }
              DocumentHelper.InsertDocument(newNode, parentNode, tree);
          }

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

• 删除节点

          public void DeleteNode(string nodeAliasPath)
          {
              var tree = new TreeProvider(CMSContext.CurrentUser);
              var deleteNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, nodeAliasPath, "fi-FI", true);
              if (deleteNode != null)
              {
                  DocumentHelper.DeleteDocument(deleteNode, tree, true, true, true);
              }
          }

  关于DeleteDocument的说明，如下图
  

• 修改节点内容

          public void UpdateNode(string nodeAliasPath,List<string[]> categorys )
          {
              var tree = new TreeProvider(CMSContext.CurrentUser);
              var updateNode = tree.SelectSingleNode(CMSContext.CurrentSiteName, nodeAliasPath, "fi-FI", true);
              updateNode.DocumentName = categorys[1][0];
              for (int i = 1; i < categorys[0].Length-1;i++ )
              {
                  updateNode.SetValue(categorys[0][i], categorys[1][i]);
              }
              DocumentHelper.UpdateDocument(updateNode, tree);
          }

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

 

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

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

 

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