SitecoreQueryCheatSheet.docx

Sitecore查询速查表（SitecoreQueryCheatSheet）是Sitecore开发中的一个重要工具，它提供了对Sitecore内容数据库进行查询和筛选的常用属性、函数和操作符。Sitecore是一个强大的内容管理系统，其强大的查询能力使得开发者可以精确地定位和操作数据。 1. **Item Attributes**: - `@@name`: 项的名称，大小写敏感。 - `@__Display name`: 显示名称，用于用户界面。 - `@@key`: 项的键，转换为小写。 - `@__Updated`: 更新日期/时间。 - `@@templateid`: 项模板的ID。 - `@@Updated by`: 更新者，大小写敏感的用户名。 - `@@templatename`: 模板的名称，大小写敏感。 - `@__Created`: 创建日期/时间。 - `@@templatekey`: 模板的键，转换为小写。 - `@@Created by`: 创建者，大小写敏感的用户名。 - `@@id`: 项的ID。 - `@@lock`: 锁定的所有者。 - `@@masterid`: 项使用的分支模板。 - `@@workflowstate`: 工作流状态ID。 2. **支持的函数**: - `contains()`: 检查字符串是否包含指定子字符串。 - `startswith()`: 检查字符串是否以指定字符串开头。 - `endswith()`: 检查字符串是否以指定字符串结尾。 - `not()`: 逻辑非运算，返回与条件相反的结果。 - `position()`: 获取项在集合中的位置。 - `ancestor()`: 获取项的祖先。 - `ancestor-or-self()`: 获取项及其祖先。 - `child()` 或 `/*`: 获取项的子项。 - `descendant()` 或 `//*`: 获取项的后代。 - `descendant-or-self()`: 获取项及其后代。 - `following()`: 获取位于项之后的排序的兄弟项。 - `parent()`: 获取项的父项。 - `preceding()`: 获取位于项之前排序的兄弟项。 - `self (.)`: 获取项本身。 - `[index]`: 通过索引获取子项，如`[5]`获取第五个子项。 3. **运算符**: - `and`: 逻辑与运算。 - `or`: 逻辑或运算。 - `xor`: 逻辑异或运算。 - `|`: 字符串连接。 - `+`: 加法。 - `-`: 减法。 - `*`: 乘法。 - `/`: 除法。 - `mod`: 求余数。 - `=`: 等于比较。 - `!=`: 不等于比较。 - `<`: 小于。 - `<=`: 小于或等于。 - `>`: 大于。 - `>=`: 大于或等于。 - `false`: 返回false。 - `true`: 返回true。 - `not()`: 逻辑非运算。 4. **日期比较**: - 使用`@__Updated`等日期字段，配合比较运算符进行日期比较，例如`[@__Updated > 'yyyyMMddTHHmmss']`。 5. **APIs**: - `Sitecore.Data.Database`: 代表Sitecore数据库的对象。 - `Sitecore.Data.Items.Item.Axes.SelectItems()`: 选取项的子项。 - `Sitecore.Data.Items.Item.Axes.SelectSingleItem()`: 选取单个子项。 - `Sitecore.Data.Query.QueryExecute()`: 执行查询。 6. **原型和字段名称的转义**: - 当值包含特殊字符时，使用哈希字符 (#) 进行转义，如`#item-name#`和`#field-name#`。 7. **日期格式**: - 使用`yyyyMMddTHHmmss`格式来比较日期字段。 8. **多选字段比较**: - `/*/content//*[contains(@ChecklistMultilistTreelistOrTreelistExField, '<ItemID>']`: 检查项中多选字段是否包含指定ID的项。 Sitecore查询语言的强大之处在于它能够结合这些元素，创建出复杂的查询，以满足特定的业务需求。通过熟练掌握这些属性、函数和操作符，开发者可以更高效地在Sitecore环境中工作。