Поделиться через


WebPart.Verbs Свойство

Определение

Возвращает коллекцию пользовательских команд, связанных с элементом управления WebPart.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ Verbs { System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection Verbs { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Verbs : System.Web.UI.WebControls.WebParts.WebPartVerbCollection
Public Overridable ReadOnly Property Verbs As WebPartVerbCollection

Значение свойства

WebPartVerbCollection, содержащий пользовательские объекты WebPartVerb, связанные с элементом управления WebPart. Значение по умолчанию — Empty.

Реализации

Атрибуты

Примеры

В следующем примере кода показано, как получить доступ к свойству Verbs пользовательского элемента управления веб-частей. В этом примере предполагается использование пользовательского элемента управления , TextDisplayWebPartсозданного в разделе WebPart Пример обзора класса.

Обратите внимание, что для работы примера кода необходимо добавить параметр в файл Web.config, чтобы включить экспорт файлов описания веб-частей. Убедитесь, что у вас есть файл Web.config в том же каталоге, что и веб-страница для этого примера кода. Убедитесь, что в <system.web> разделе есть <webParts> элемент с атрибутом enableExport , равным true, как показано в следующей разметке.

<webParts enableExport="true">

...

</webParts>

Загрузите веб-страницу в браузере. При нажатии кнопки Display Verb Count он обращается к свойству Verbs , чтобы получить количество пользовательских глаголов для TextDisplayWebPart элемента управления, и отображает счетчик в метке. Так как в этом случае в элемент управления не были добавлены пользовательские команды, число равно нулю.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

void  button1_Click(object sender, EventArgs e)
{
  label1.Text = "Verb count = " + 
    textwebpart.Verbs.Count.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      OnClick="button1_Click" 
      Text="Display Verb Count" 
      />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    label1.Text = "Verb Count = " & _
      textwebpart.Verbs.Count.ToString()
    
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            ExportMode="all" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      Text="Display Verb Count" OnClick="button1_Click" />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

Комментарии

Команды являются производными WebPartVerb от класса и предоставляют действия пользовательского интерфейса, которые пользователи могут выполнять с элементом WebPart управления. Обычно глаголы представлены в пользовательском интерфейсе в виде кнопок, ссылок или пунктов меню. По умолчанию распространенные команды веб-частей отображаются в раскрывающемся меню команд в строке заголовка каждого WebPart элемента управления. Существуют стандартные команды для открытия, закрытия, редактирования и минимизации элемента управления, а также другие команды для экспорта определения элемента управления или загрузки файла справки. Эти команды не включаются в коллекцию Verbs , так как коллекция содержит только пользовательские команды, которые создаются и возвращаются путем переопределения этого свойства в производном классе.

При создании пользовательских глаголов и их добавлении в коллекцию Verbs вы можете получить доступ к командам программным способом WebPart из элемента управления .

Примечания для тех, кто наследует этот метод

Производные классы могут переопределить Verbs свойство , чтобы пользователи могли добавлять пользовательские WebPartVerb объекты в коллекцию глаголов для WebPart элемента управления .

Применяется к

См. также раздел