ConnectionsZone.ConfigureVerb Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá odkaz na WebPartVerb objekt použitý k otevření zobrazení konfigurace v uživatelském rozhraní (UI) připojení.

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

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

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

Public Overridable ReadOnly Property ConfigureVerb As WebPartVerb

Hodnota vlastnosti

WebPartVerb

Slouží WebPartVerb k otevření části Konfigurace připojení v uživatelském rozhraní připojení.

Atributy: PersistenceModeAttribute

Příklady

Následující příklad kódu ukazuje použití ConfigureVerb vlastnosti s ovládacím prvku ConnectionsZone . Příklad obsahuje pouze kód pro webovou stránku, která demonstruje použití vlastnosti; pro další dva soubory kódu potřebné ke spuštění příkladu najdete v části Příklad v přehledu ConnectionsZone třídy. Příklad kódu má čtyři části:

Uživatelský ovládací prvek, který umožňuje přepínat režimy zobrazení na webové stránce. Získejte tento kód z přehledu ConnectionsZone třídy.
Zdrojový soubor, který obsahuje kód pro rozhraní PSČ a dva WebPart ovládací prvky, které fungují jako zprostředkovatel a příjemce připojení. Získejte tento kód z přehledu ConnectionsZone třídy.
Webová stránka, která je hostitelem všech ovládacích prvků, deklaruje <asp:connectionszone> prvek a ukazuje, jak tuto vlastnost používat deklarativně a programově.
Vysvětlení fungování příkladu v prohlížeči

Webová stránka deklaruje <asp:connectionszone> prvek a v rámci elementu deklaruje <configureverb> prvek a nastaví vlastnost pomocí atributů. Kód také v Page_PreRender metodě nastaví vlastnost příkazu configure pro ConnectionsZone ovládací prvek.

<%@ 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>

Načtěte stránku v prohlížeči. Přepněte do režimu připojení pomocí ovládacího prvku Režim zobrazení . Klikněte na šipku nabídky sloves v ovládacím prvku Zprostředkovatel PSČ a klikněte na příkaz připojit. Všimněte si, že existuje tlačítko Ukončit připojení pro odpojení ovládacích prvků, které jsou již připojené, a zakázané tlačítko Konfigurovat . Pokud váš příklad kódu používal transformátor, který obsahoval průvodce konfigurací, bylo by tlačítko Konfigurovat povolené a uživatelé by na něj mohli kliknout a nakonfigurovat připojení. Pokud umístíte ukazatel myši na tlačítko Konfigurovat v uživatelském rozhraní připojení, zobrazí se v popisku text vlastního popisu.

Poznámky

Příkaz konfigurovat se zobrazí v části Spravovat připojení uživatelského rozhraní připojení, pokud už připojení existuje a uživatel otevřel uživatelské rozhraní připojení. Uživatelské rozhraní zobrazí uživatelům tlačítko Ukončit připojení pro ukončení připojení a tlačítko Konfigurovat (které představuje příkaz konfigurovat) pro konfiguraci připojení. Pokud uživatel klikne na tlačítko Konfigurovat , zobrazí se část Konfigurovat připojení uživatelského rozhraní, která uživatelům umožní nakonfigurovat připojení. Tato možnost konfigurace připojení (a tím i tlačítka Konfigurovat ) je povolená pouze v případě, že připojení používá transformátor a transformátor obsahuje ovládací prvek průvodce konfigurací (Wizard), který umožňuje, aby ho uživatelé nakonfigurovali. Podrobnosti najdete ve WebPartTransformer třídě.

ConfigureVerb Pomocí vlastnosti získáte odkaz na odpovídající WebPartVerb objekt v uživatelském rozhraní. I když je samotná vlastnost jen pro čtení, po získání odkazu na příkaz můžete podle potřeby změnit její hodnoty vlastností.

Hodnoty vlastností příkazu configure můžete deklarativně nastavit deklarací elementu <configureverb> v rámci značek elementu <asp:connectionszone> . Vlastnosti slovesa lze nastavit deklarativně ve tvaru Property-Subproperty, kde Subproperty je vlastnost objektu WebPartVerb (například ConfigureVerb-Text). Vlastnosti můžete také nastavit programově ve formuláři Property.Subproperty (například ConfigureVerb.Text).

Platí pro

Sdílet prostřednictvím