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>trueатрибутов enableExport имеет значение , как показано в следующей разметке.
<webParts enableExport="true">
...
</webParts>
Загрузите веб-страницу в браузере. При нажатии кнопки "Счетчик глаголов отображения " он обращается к 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 элемента управления.