SettingsLink 类

实现呈现 Web 部件页菜单 （修改共享网页或修改我的网页）。

继承层次结构

System.Object
  System.Web.UI.Control
    Microsoft.SharePoint.WebPartPages.SettingsLink

命名空间：  Microsoft.SharePoint.WebPartPages
程序集：  Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）

语法

声明
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class SettingsLink _
    Inherits Control _
    Implements IDesignTimeHtmlProvider
用法
Dim instance As SettingsLink

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class SettingsLink : Control, 
    IDesignTimeHtmlProvider

备注

如果用户具有足够的权限修改页，将仅显示由SettingsLink类实现 Web 部件菜单。在菜单上显示的菜单选项还取决于用户的权限。

如果打开匿名访问，直到用户进行身份验证，将不会呈现 Web 部件页菜单。在这种情况下， AuthenticationButton控件应添加到页面。

呈现由SettingsLink类菜单上等同于在TitleBarWebPart中呈现的菜单。

示例

下面的代码示例演示如何更改的 Web 部件页菜单上显示。

Imports System
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports Microsoft.SharePoint.WebPartPages
Imports Microsoft.SharePoint
Imports System.Xml.Serialization


Namespace SettingsLinkExample
   <XmlRoot([Namespace] := "SettingsLinkExample"), 
      ToolboxData("<{0}:WPRenderSettingsLink 
      runat=server></{0}:WPRenderSettingsLink>")>  _
   Public Class WPRenderSettingsLink
      
      Inherits Microsoft.SharePoint.WebPartPages.WebPart
      Private mylink1 As Microsoft.SharePoint.WebPartPages.SettingsLink
      Private mylink2 As Microsoft.SharePoint.WebPartPages.SettingsLink
      Private mylink3 As Microsoft.SharePoint.WebPartPages.SettingsLink
      Private mylink4 As Microsoft.SharePoint.WebPartPages.SettingsLink
      
      Public Sub New()
      End Sub
      
      Protected Overrides Sub CreateChildControls()
         Dim [text] As LiteralControl
         [text] = New LiteralControl("<br>No Text specified:<br>")
         Me.Controls.Add([text])
         mylink1 = New Microsoft.SharePoint.WebPartPages.SettingsLink()
         Me.Controls.Add(mylink1)
         [text] = New LiteralControl("<br>")
         Me.Controls.Add([text])
         [text] = New LiteralControl("<hr><br>Text specified and 
            font:<br><FONT face=Verdana size=6>")
         Me.Controls.Add([text])
         mylink2 = New Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText")
         Me.Controls.Add(mylink2)
         [text] = New LiteralControl("</font><br>")
         Me.Controls.Add([text])
         
         [text] = New LiteralControl("<hr><br>Text specified no font:<br>")
         Me.Controls.Add([text])
         mylink3 = New Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText")
         Me.Controls.Add(mylink3)
         [text] = New LiteralControl("<br>")
         Me.Controls.Add([text])
         
         [text] = New LiteralControl("<hr><br>Text specified splink 
            added:<br><table><tr><td align=""right"" valign=""bottom"" 
            class=""ms-SPLink"" style=""padding:5px"">")
         Me.Controls.Add([text])
         mylink4 = New Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText")
         Me.Controls.Add(mylink4)
         [text] = New LiteralControl("</td></tr></table>")
         Me.Controls.Add([text])
      End Sub
      
      
      ' Render the WebPart
      Protected Overrides Sub RenderWebPart(output As HtmlTextWriter)
         Me.EnsureChildControls()
         Me.RenderChildren(output)
      End Sub
   End Class
End Namespace

using System;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
using Microsoft.SharePoint.WebPartPages;
using Microsoft.SharePoint;
using System.Xml.Serialization;

namespace SettingsLinkExample
{
    [XmlRoot(Namespace="SettingsLinkExample")]
    [ToolboxData("<{0}:WPRenderSettingsLink 
        runat=server></{0}:WPRenderSettingsLink>")]

    public class WPRenderSettingsLink : 
        Microsoft.SharePoint.WebPartPages.WebPart
    {
        private Microsoft.SharePoint.WebPartPages.SettingsLink mylink1;
        private Microsoft.SharePoint.WebPartPages.SettingsLink mylink2;
        private Microsoft.SharePoint.WebPartPages.SettingsLink mylink3;
        private Microsoft.SharePoint.WebPartPages.SettingsLink mylink4;

        public WPRenderSettingsLink()
             {
             }

        protected override void CreateChildControls()
        {
            LiteralControl text;
            text = new LiteralControl("<br>No Text specified:<br>");
            this.Controls.Add(text);
            mylink1 = new Microsoft.SharePoint.WebPartPages.SettingsLink();
            this.Controls.Add(mylink1);
            text = new LiteralControl("<br>");
            this.Controls.Add(text);
            text = new LiteralControl("<hr><br>Text specified and 
                font:<br><FONT face=Verdana size=6>");
            this.Controls.Add(text);
            mylink2 = new Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText");
            this.Controls.Add(mylink2);
            text = new LiteralControl("</font><br>");
            this.Controls.Add(text);

            text = new LiteralControl("<hr><br>Text specified no font:<br>");
            this.Controls.Add(text);
            mylink3 = new Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText");
            this.Controls.Add(mylink3);
            text = new LiteralControl("<br>");
            this.Controls.Add(text);

            text = new LiteralControl("<hr><br>Text specified splink 
                added:<br><table><tr><td align=\"right\" 
                valign=\"bottom\" class=\"ms-SPLink\" 
                style=\"padding:5px\">");
            this.Controls.Add(text);
            mylink4 = new Microsoft.SharePoint.WebPartPages.SettingsLink("LinkText");
            this.Controls.Add(mylink4);
            text = new LiteralControl("</td></tr></table>");
            this.Controls.Add(text);
        }

        // Render the WebPart
        protected override void RenderWebPart(HtmlTextWriter output)
        {
            this.EnsureChildControls();
            this.RenderChildren(output);
        }
    }
}

线程安全性

该类型的任何公共 静态 (已共享 在 Visual Basic 中) 成员都是线程安全的。不保证任何实例成员都是线程安全的。

另请参阅

引用

SettingsLink 成员

Microsoft.SharePoint.WebPartPages 命名空间