ConnectionsZone.ConnectVerb 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, který umožňuje vytvořit připojení dva WebPart ovládací prvky.

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

Hodnota vlastnosti

WebPartVerb

A WebPartVerb , který umožňuje vytvořit připojení dvěma ovládacími prvky.

Atributy: PersistenceModeAttribute

Příklady

Následující příklad kódu ukazuje použití ConnectVerb vlastnosti s ovládacím ConnectionsZone prvku. Příklad obsahuje pouze kód webové stránky, která demonstruje použití vlastnosti; další dva soubory kódu potřebné ke spuštění příkladu najdete v části Příklad 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 poskytovatel 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 používat vlastnost deklarativním a programovým způsobem.
Vysvětlení toho, jak příklad funguje v prohlížeči

Webová stránka deklaruje <asp:connectionszone> prvek a v rámci značek elementu <connectverb> deklaruje prvek a nastaví některé vlastnosti pomocí atributů. V Page_PreRender metodě kód také nastaví některé vlastnosti pro příkaz connect 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 příkazy v ovládacím prvku Zprostředkovatele PSČ a klikněte na příkaz připojit. Kliknutím na tlačítko Ukončit připojení odpojíte ovládací prvky, které jsou již připojené kvůli deklarativnímu připojení na stránce. Klikněte na možnost Vybrat příjemce, aby se poskytovatel připojil s hypertextovým odkazem , a všimněte si efektu nastavení různých vlastností. Pokud umístíte ukazatel myši na tlačítko Připojení Ovládací prvky, zobrazí se v popisu vlastní text popisu.

Poznámky

Příkaz connect, jak se používá s ovládacím ConnectionsZone prvek, je příkaz na úrovni zóny, který se zobrazí v uživatelském rozhraní připojení (UI) jako součást zobrazení, ve kterém uživatelé finalizují propojení mezi dvěma ovládacími prvky. V části uživatelského rozhraní, kde uživatelé můžou vybrat spojovací body, pokud se můžou připojit dva ovládací prvky, je příkaz pro připojení povolený v dolní části uživatelského rozhraní. Po výběru spojovacího bodu můžou uživatelé kliknout na příkaz pro připojení a vytvořit připojení.

Poznámka

Spojení na úrovni zóny popsané v tomto tématu ve skutečnosti vytvoří spojení mezi ovládacími prvky a liší se od slovesa, který se zobrazí v nabídce WebPart sloves ovládacího prvku. Když uživatel přepne webovou stránku, aby se připojil režim zobrazení, pokud ovládací prvek může vytvořit připojení, WebPart zobrazí se v nabídce slovesa připojení. Tímto WebPart příkazem pro připojení se jednoduše otevře uživatelské rozhraní připojení vytvořené ovládacím ConnectionsZone prvekem. Naproti tomu ConnectVerb sloveso popsané v tomto tématu, které funguje na úrovni zóny, ve skutečnosti vytvoří připojení.

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

Hodnoty vlastností příkazu connect můžete deklarovat deklarací <connectverb> prvku mezi levou a pravou značkou <asp:connectionszone> prvku. Vlastnosti slovesa lze také deklarativní nastavit v rámci úvodní značky <asp:connectionszone> elementu přidáním atributu ve formuláři Property-Subproperty, kde Subproperty je vlastnost WebPartVerb objektu (například ConnectVerb-Text). Vlastnosti můžete také nastavit programově ve formuláři Property.Subproperty (například ConnectVerb.Text).

Platí pro

Viz také

WebPartVerb

Sdílet prostřednictvím