通过

将 XML 命名空间添加到属性提供程序映射 <add>

  • 项目

概述

<properties> 元素的 <add> 元素定义 XML 命名空间到属性存储提供程序的映射。

注意

WebDAV 定义了两种类型的属性：

  • 活属性：这些属性存在于基础文件系统中。 例如，文件名和文件大小。 始终支持这些属性。
  • 死属性：这些属性是用户定义的，存储在属性存储中。 例如，文档的作者或所使用的模板。

若要使用“dead”属性，必须将 <properties> 元素的 allowCustomProperties 设置为 true，并根据 <propertyStores> 集合中定义的属性提供程序列表来定义 XML 命名空间到属性提供程序的映射。

兼容性

版本 说明
IIS 10.0 <add> 元素在 IIS 10.0 中未进行修改。
IIS 8.5 <add> 元素在 IIS 8.5 中未进行修改。
IIS 8.0 <add> 元素在 IIS 8.0 中未进行修改。
IIS 7.5 <properties> 元素的 <add> 元素作为 IIS 7.5 的功能提供。
IIS 7.0 <properties> 元素的 <add> 元素是在 IIS 7.0 的独立下载项 WebDAV 7.0 中引入的。
IIS 6.0 空值

安装

若要支持 Web 服务器的 WebDAV 发布，必须安装 WebDAV 模块。 为此，请按照以下步骤操作。

Windows Server 2012 或 Windows Server 2012 R2

  1. 在任务栏上，单击 “服务器管理器”。
  2. 在“服务器管理器”中，单击“管理”菜单，然后单击“添加角色和功能”。
  3. 在“添加角色和功能”向导中，单击“下一步”。 选择安装类型，然后单击“下一步”。 选择目标服务器，然后单击“下一步”。
  4. 在“服务器角色”页，依次展开“Web 服务器 (IIS)”、“Web 服务器”和“常见 HTTP 功能”，然后选择“WebDAV 发布”。 单击 “下一步” 。
    Screenshot of Web Server I I S and Common H T T P Feature directory expanded with Web Dav Publishing selected.
  5. 在“选择功能”页上，单击“下一步”。
  6. 在“确认安装选择”页上，单击“安装”。
  7. 在“结果” 页面中单击“关闭” 。

Windows 8 或 Windows 8.1

  1. 在“开始”屏幕上，将指针一直移动到左下角，右键单击“开始”按钮，然后单击“控制面板”。
  2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。
  3. 依次展开“Internet Information Services”、“万维网服务”和“常见 HTTP 功能”，然后选择“WebDAV 发布”。
    Screenshot of Turn Windows features on or off window with Web DAV Publishing selected.
  4. 单击“确定”。
  5. 单击“关闭” 。

Windows Server 2008 R2

  1. 在任务栏上，单击“开始”，指向“管理工具”，然后单击“服务器管理器”。
  2. 在“服务器管理器”层次结构窗格中，展开“角色”，然后单击“Web 服务器(IIS)”。
  3. 在“Web 服务器 (IIS)”窗格中，滚动到“角色服务”部分，然后单击“添加角色服务”。
  4. 在“添加角色服务向导”的“选择角色服务”页，展开“常见 HTTP 功能”，选择“WebDAV 发布”，然后单击“下一步”。
    Screenshot of Select Role Services page displaying the Sever Manager hierarchy pane with Web DAV Publishing selected.
  5. 在“确认安装选择”页中，单击“安装”。
  6. 在“结果” 页面中单击“关闭” 。

Windows 7

  1. 在任务栏上，单击“开始”，然后单击“控制面板”。
  2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。
  3. 依次展开“Internet Information Services”、“万维网服务”和“常见 HTTP 功能”。
  4. 选择“WebDAV 发布”，然后单击“确定”。
    Screenshot of Turn Windows features on or off with World Wide Web Services pane expanded and Web DAV Publishing selected.

Windows Server 2008 或 Windows Vista

操作方式

如何为网站配置 WebDAV 属性

  1. 打开 Internet Information Services (IIS) 管理器：

    • 如果使用的是 Windows Server 2012 或 Windows Server 2012 R2：

      • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS)管理器”。

    • 如果使用的是 Windows 8 或 Windows 8.1：

      • 按住 Windows 键，按字母 X，然后单击“控制面板”。
      • 单击“管理工具”，然后双击“Internet 信息服务(IIS)管理器”。

    • 如果使用的是 Windows Server 2008 或 Windows Server 2008 R2：

      • 在任务栏上，单击“开始”，指向“管理工具”，然后单击“Internet Information Services (IIS)管理器”。

    • 如果使用的是 Windows Vista 或 Windows 7：

      • 在任务栏上，单击“开始”，然后单击“控制面板”。
      • 双击“管理工具”，然后双击“Internet 信息服务(IIS)管理器”。

  2. 在“连接”窗格中，展开服务器名称，展开“站点”节点，然后单击站点名称。

  3. 在站点的“主页”窗格中双击“WebDAV 创作规则”。
    Screenshot of I I S Manager Console displaying Site Home pane with Web DAV Authoring Rules selected.

  4. 当显示“WebDAV 创作规则”页后，单击“操作”页中的“WebDAV 设置”。
    Screenshot of Web DAV Authoring Rules page with Web DAV Settings displayed in Action pane.

  5. 显示“WebDAV 设置”页后，请在“属性行为”部分指定以下选项：

    • 将“允许匿名属性查询”设置为 False。

    • 将“允许自定义属性”设置为 True。

    • 将“允许深度不受限制的属性查询”设置为 False。

      Screenshot of Web DAV Settings page displaying different options in Property Behavior section set to true or false.

  6. 单击省略号 (...) 按钮启动命名空间集合编辑器。
    Screenshot of Namespace Collection Editor with web dav dash simple dash prop selected from the drop down list.

  7. 单击“添加”，然后从下拉列表中选择“webdav_simple_prop”

  8. 为 XmlNameSpace 指定“*”，然后单击“确定”。

  9. 完成上述步骤后，单击“操作”窗格中的“应用”。

配置

<properties> 元素只能在 ApplicationHost.config 文件中的服务器级别进行配置。 如果 <properties> 元素是在其他级别定义的，或是包含在 Web.config 文件中，则将被忽略。

特性

属性 说明
xmlNamespace 必需的字符串属性。 指定映射的 XML 命名空间。

注意：通配符“*”字符用于定义默认命名空间映射，没有唯一映射的任何命名空间都将使用通配符映射。 如果 WebDAV 客户端使用的 XML 命名空间没有特定的命名空间映射，并且不存在通配符映射，则无法存储属性。 默认值为 false。
propertyStore 必需的字符串属性。

指定映射的属性存储。

注意：属性存储的名称必须在 <propertyStores> 集合中定义。

默认值为 false。

子元素

无。

配置示例

以下示例列出了默认网站的示例 <webdav> 元素。 此示例清除所有现有创作规则，为管理员组添加一条规则，启用 WebDAV 创作，指定允许隐藏文件，启用 WebDAV 锁并指定锁提供程序，同时启用 WebDAV 属性并指定属性映射的默认 XML 命名空间。

<location path="Default Web Site">
   <system.webServer>
      <webdav>
         <authoringRules defaultAccess="none" allowNonMimeMapFiles="true" defaultMimeType="text/plain">
            <clear />
            <add roles="administrators" path="*" access="Read, Write, Source" />
         </authoringRules>
         <authoring enabled="true" requireSsl="false">
            <fileSystem allowHiddenFiles="true" />
            <locks enabled="true" lockStore="webdav_simple_lock" requireLockForWriting="false" />
            <properties allowAnonymousPropfind="false" allowInfinitePropfindDepth="false" allowCustomProperties="true">
               <clear />
               <add xmlNamespace="*" propertyStore="webdav_simple_prop" />
            </properties>
         </authoring>
      </webdav>
   </system.webServer>
</location>

代码示例

以下示例将配置 WebDAV 属性设置，以禁用匿名和无限深度属性查询，并使用映射到内置 webdav_simple_prop 提供程序的默认 XML 命名空间来启用自定义属性。

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoring /properties.allowAnonymousPropfind:"False" /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoring /properties.allowInfinitePropfindDepth:"False" /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoring /properties.allowCustomProperties:"True" /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoring /+"properties.[xmlNamespace='*',propertyStore='webdav_simple_prop']" /commit:apphost

注意

使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 apphost。 这会将配置设置提交到 ApplicationHost.config 文件中的相应位置部分。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection authoringSection = config.GetSection("system.webServer/webdav/authoring", "Default Web Site");

         ConfigurationElement propertiesElement = authoringSection.GetChildElement("properties");
         propertiesElement["allowAnonymousPropfind"] = false;
         propertiesElement["allowInfinitePropfindDepth"] = false;
         propertiesElement["allowCustomProperties"] = true;

         ConfigurationElementCollection propertiesCollection = propertiesElement.GetCollection();

         ConfigurationElement addElement = propertiesCollection.CreateElement("add");
         addElement["xmlNamespace"] = @"*";
         addElement["propertyStore"] = @"webdav_simple_prop";
         propertiesCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim authoringSection As ConfigurationSection = config.GetSection("system.webServer/webdav/authoring", "Default Web Site")

      Dim propertiesElement As ConfigurationElement = authoringSection.GetChildElement("properties")
      propertiesElement("allowAnonymousPropfind") = False
      propertiesElement("allowInfinitePropfindDepth") = False
      propertiesElement("allowCustomProperties") = True

      Dim propertiesCollection As ConfigurationElementCollection = propertiesElement.GetCollection

      Dim addElement As ConfigurationElement = propertiesCollection.CreateElement("add")
      addElement("xmlNamespace") = "*"
      addElement("propertyStore") = "webdav_simple_prop"
      propertiesCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var authoringSection = adminManager.GetAdminSection("system.webServer/webdav/authoring", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var propertiesElement = authoringSection.ChildElements.Item("properties");
propertiesElement.Properties.Item("allowAnonymousPropfind").Value = false;
propertiesElement.Properties.Item("allowInfinitePropfindDepth").Value = false;
propertiesElement.Properties.Item("allowCustomProperties").Value = true;

var propertiesCollection = propertiesElement.Collection;

var addElement = propertiesCollection.CreateNewElement("add");
addElement.Properties.Item("xmlNamespace").Value = "*";
addElement.Properties.Item("propertyStore").Value = "webdav_simple_prop";
propertiesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set authoringSection = adminManager.GetAdminSection("system.webServer/webdav/authoring", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set propertiesElement = authoringSection.ChildElements.Item("properties")
propertiesElement.Properties.Item("allowAnonymousPropfind").Value = False
propertiesElement.Properties.Item("allowInfinitePropfindDepth").Value = False
propertiesElement.Properties.Item("allowCustomProperties").Value = True

Set propertiesCollection = propertiesElement.Collection

Set addElement = propertiesCollection.CreateNewElement("add")
addElement.Properties.Item("xmlNamespace").Value = "*"
addElement.Properties.Item("propertyStore").Value = "webdav_simple_prop"
propertiesCollection.AddElement(addElement)

adminManager.CommitChanges()