如何将自定义母版页应用于SharePoint托管型应用

嘿，我来帮你搞定这个问题！在SharePoint托管型应用里应用自定义母版页，得注意沙盒环境的限制，不过还是有几种可靠的方法，咱们一步步来：

方法1：直接修改单个页面的母版页引用（比如Default.aspx） #

这是最直接的方式，针对单个页面生效：

1. 先把你的自定义母版页上传到应用站点的Master Page Gallery（_catalogs/masterpage）或者Style Library里，记得发布成主要版本，确保能被访问到。
2. 修改Default.aspx的Page指令，把原来的MasterPageFile="~masterurl/default.master"替换成自定义母版页的具体路径：

   <%@ Page Inherits="Microsoft.SharePoint.WebPartPages.WebPartPage, Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" MasterPageFile="~site/_catalogs/masterpage/你的自定义母版页名称.master" Language="C#" %>
   

   如果是要引用seattle.Master，路径就是~site/_catalogs/masterpage/seattle.master，替换后即可生效。

小提示：~masterurl/default.master是动态引用当前站点的默认母版页，换成具体路径就能强制页面使用指定的母版页。

方法2：批量应用到多个页面（通过Feature激活） #

如果你需要让应用里的多个页面都使用自定义母版页，可以写一段Feature激活代码来批量修改：

public override void FeatureActivated(SPFeatureReceiverProperties properties)
{
    SPWeb web = properties.Feature.Parent as SPWeb;
    if (web == null) return;

    // 替换成你的自定义母版页的服务器相对路径
    string customMasterUrl = "_catalogs/masterpage/CustomMaster.master";
    SPFile masterFile = web.GetFile(customMasterUrl);
    
    if (!masterFile.Exists)
    {
        // 如果母版页不存在，记得做容错处理
        return;
    }

    // 遍历站点下的所有ASPX页面
    foreach (SPFile file in web.Files)
    {
        if (file.Name.EndsWith(".aspx", StringComparison.OrdinalIgnoreCase))
        {
            using (SPLimitedWebPartManager wpm = file.GetLimitedWebPartManager(PersonalizationScope.Shared))
            {
                file.Properties["MasterPageFile"] = masterFile.ServerRelativeUrl;
                file.Update();
            }
        }
    }
}

把这段代码放到你的Feature接收器里，激活Feature时就会自动把所有ASPX页面的母版页换成自定义的。

关键注意事项 #

• 沙盒限制：自定义母版页不能包含沙盒不允许的控件或代码，比如未授权的服务器控件，否则会报错。
• 母版页发布：上传母版页后一定要发布成主要版本，否则页面可能无法加载到母版页。
• 兼容性：如果你的应用要兼容SharePoint 2013和Online，自定义母版页要适配这两个环境，seattle.Master本身是兼容的，不用担心。

内容的提问来源于stack exchange，提问作者kumar krishnan