ConnectionsZone.ConnectVerb Свойство

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls.WebParts

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ ConnectVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb ConnectVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.ConnectVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property ConnectVerb As WebPartVerb

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

WebPartVerb

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

Атрибуты: PersistenceModeAttribute

Примеры

В следующем примере кода показано использование ConnectVerb свойства с элементом ConnectionsZone управления. В примере содержится только код веб-страницы, демонстрирующий использование свойства; сведения о двух других файлах кода, необходимых для запуска примера, см. в ConnectionsZone разделе "Пример" обзора класса. Пример кода состоит из четырех частей:

Пользовательский элемент управления, позволяющий переключать режимы отображения на веб-странице. Получите этот код из ConnectionsZone обзора класса.
Исходный файл, содержащий код для интерфейса ZIP-кода, и два WebPart элемента управления, действующие в качестве поставщика и потребителя для подключения. Получите этот код из ConnectionsZone обзора класса.
Веб-страница, на котором размещаются все элементы управления, объявляет <asp:connectionszone> элемент и показывает, как декларативно и программно использовать свойство.
Объяснение того, как работает пример в браузере.

Веб-страница объявляет <asp:connectionszone> элемент и в тегах элемента объявляет <connectverb> элемент и задает некоторые свойства с помощью атрибутов. Кроме того, в методе Page_PreRender код задает некоторые свойства команды connect для ConnectionsZone элемента управления.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuCS"
    src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_PreRender(object sender, EventArgs e)
  {
     // Set properties on verbs.
     connectionsZone1.CancelVerb.Description = 
       "Terminates the connection process";
     connectionsZone1.CloseVerb.Description = 
       "Closes the connections UI";
     connectionsZone1.ConfigureVerb.Description =
       "Configure the transformer for the connection";
     connectionsZone1.ConnectVerb.Description =
       "Connect two WebPart controls";
     connectionsZone1.DisconnectVerb.Description =
       "End the connection between two controls";
    
     // Set properties for UI text strings.
     connectionsZone1.ConfigureConnectionTitle = 
       "Configure";
     connectionsZone1.ConnectToConsumerInstructionText = 
       "Choose a consumer connection point";
     connectionsZone1.ConnectToConsumerText = 
       "Select a consumer for the provider to connect with";
     connectionsZone1.ConnectToConsumerTitle = 
       "Send data to this consumer";
     connectionsZone1.ConnectToProviderInstructionText =
       "Choose a provider connection point";
     connectionsZone1.ConnectToProviderText =
       "Select a provider for the consumer to connect with";
     connectionsZone1.ConnectToProviderTitle =
       "Get data from this provider";
     connectionsZone1.ConsumersInstructionText = 
       "WebPart controls that receive data from providers";
     connectionsZone1.ConsumersTitle = "Consumer Controls";
     connectionsZone1.GetFromText = "Receive from";
     connectionsZone1.GetText = "Retrieve";
     connectionsZone1.HeaderText = 
      "Create and Manage Connections";
     connectionsZone1.InstructionText = 
      "Manage connections for the selected WebPart control";
     connectionsZone1.InstructionTitle = 
       "Manage connections for consumers or providers";
     connectionsZone1.NoExistingConnectionInstructionText = 
       "No connections exist. Click the above link to create "
       + "a connection.";
     connectionsZone1.NoExistingConnectionTitle = 
       "No current connections";
     connectionsZone1.ProvidersInstructionText =
       "WebPart controls that send data to consumers";
     connectionsZone1.ProvidersTitle = "Provider controls";
     
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenucs id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider"  />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuVB"
    src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Set properties for verbs.
    connectionsZone1.CancelVerb.Description = _
      "Terminates the connection process"
    connectionsZone1.CloseVerb.Description = _
      "Closes the connections UI"
    connectionsZone1.ConfigureVerb.Description = _
      "Configure the transformer for the connection"
    connectionsZone1.ConnectVerb.Description = _
      "Connect two WebPart controls"
    connectionsZone1.DisconnectVerb.Description = _
      "End the connection between two controls"
    
    ' Set properties for UI text strings.
    connectionsZone1.ConfigureConnectionTitle = _
      "Configure a new connection"
    connectionsZone1.ConnectToConsumerInstructionText = _
      "Choose a consumer connection point"
    connectionsZone1.ConnectToConsumerText = _
      "Select a consumer for the provider to connect with"
    connectionsZone1.ConnectToConsumerTitle = _
      "Send data to this consumer"
    connectionsZone1.ConnectToProviderInstructionText = _
      "Choose a provider connection point"
    connectionsZone1.ConnectToProviderText = _
      "Select a provider for the consumer to connect with"
    connectionsZone1.ConnectToProviderTitle = _
      "Get data from this provider"
    connectionsZone1.ConsumersInstructionText = _
      "WebPart controls that receive data from providers"
    connectionsZone1.ConsumersTitle = "Consumer Controls"
    connectionsZone1.GetFromText = "Receive from"
    connectionsZone1.GetText = "Retrieve"
    connectionsZone1.HeaderText = _
      "Create and Manage Connections"
    connectionsZone1.InstructionText = _
      "Manage connections for the selected WebPart control"
    connectionsZone1.InstructionTitle = _
      "Manage connections for consumers or providers"
    connectionsZone1.NoExistingConnectionInstructionText = _
      "No connections exist. Click the above link to create " _
      & "a connection."
    connectionsZone1.NoExistingConnectionTitle = _
      "No current connections"
    connectionsZone1.ProvidersInstructionText = _
      "WebPart controls that send data to consumers"
    connectionsZone1.ProvidersTitle = "Provider controls"

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenuvb id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider" />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

Загрузите страницу в браузере. Переключитесь в режим подключения с помощью элемента управления "Режим отображения ". Щелкните стрелку меню команд в элементе управления "Поставщик почтовых индексов " и щелкните команду connect. Нажмите кнопку "Завершить подключение" , чтобы отключить элементы управления, которые уже подключены из-за декларативного подключения на странице. Щелкните элемент Select a consumer for the provider to connect with hyperlink, and notice the effect of setting the various properties. Если наведите указатель мыши на кнопку "Элементы управления Подключение", в подсказке появится текст пользовательского описания.

Команда connect, используемая с элементом ConnectionsZone управления, — это команда уровня зоны, которая отображается в пользовательском интерфейсе соединения в представлении, в котором пользователи завершают соединение между двумя элементами управления. В части пользовательского интерфейса, где пользователи могут выбирать точки подключения, если два элемента управления могут подключаться, команда подключения включена в нижней части пользовательского интерфейса. После выбора точки подключения пользователи могут щелкнуть команду подключения, чтобы создать подключение.

Примечание

Команда подключения на уровне зоны, описанная в этом разделе, фактически устанавливает соединение между элементами управления и отличается от команды, которая отображается в меню WebPart команд элемента управления. Когда пользователь переключает веб-страницу для подключения к режиму отображения, если элемент управления может формировать подключения, команда WebPart подключения отображается в меню глаголов. Эта WebPart команда подключения просто открывает пользовательский интерфейс подключения, созданный элементом ConnectionsZone управления. В отличие от этого, команда, ConnectVerb описанная в этом разделе, которая работает на уровне зоны, фактически создает соединение.

ConnectVerb Используйте свойство, чтобы получить ссылку на соответствующий WebPartVerb объект в пользовательском интерфейсе. Несмотря на то, что само свойство доступно только для чтения, после получения ссылки на команду его значения можно изменить по мере необходимости.

Значения свойств команды connect можно задать декларативно, объявив <connectverb> элемент между открывающими и закрывающими тегами <asp:connectionszone> элемента. Свойства команды также можно задать декларативно в открываемом теге <asp:connectionszone> элемента, добавив атрибут в форму Property-Subproperty, где Subproperty является свойством WebPartVerb объекта (например, ConnectVerb-Text). Вы также можете задать свойства программным способом в форме Property.Subproperty (например, ConnectVerb.Text).

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

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

WebPartVerb