ConnectionsZone.ConnectVerb Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İki WebPart denetimin bağlantı kurmasını sağlayan bir WebPartVerb nesneye başvuru alır.

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

Özellik Değeri

WebPartVerb

WebPartVerb İki denetimin bağlantı kurmasını sağlayan bir.

Öznitelikler: PersistenceModeAttribute

Örnekler

Aşağıdaki kod örneği, özelliğinin ConnectVerb bir ConnectionsZone denetimle kullanımını gösterir. Örnek yalnızca web sayfasının özelliğinin kullanımını gösteren kodu içerir; örneği çalıştırmak için gereken diğer iki kod dosyası için, sınıfa genel bakışın ConnectionsZone Örnek bölümüne bakın. Kod örneğinin dört bölümü vardır:

Web sayfasında görüntüleme modlarını değiştirmenizi sağlayan bir kullanıcı denetimi. Bu kodu sınıfa genel bakış sayfasından ConnectionsZone alın.
Posta Kodu arabiriminin kodunu içeren bir kaynak dosya ve bağlantı için sağlayıcı ve tüketici olarak davranan iki WebPart denetim. Bu kodu sınıfa genel bakış sayfasından ConnectionsZone alın.
Tüm denetimleri barındıran, bir öğe bildiren ve özelliğin bildirim temelli ve programlı olarak nasıl kullanılacağını gösteren bir <asp:connectionszone> Web sayfası.
Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Web sayfası bir <asp:connectionszone> öğe bildirir ve öğe etiketleri içinde bir <connectverb> öğe bildirir ve öznitelikleri kullanarak bazı özellikleri ayarlar. Ayrıca, yönteminde Page_PreRender kod, denetim için ConnectionsZone bağlantı fiilinde bazı özellikleri ayarlar.

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

Sayfayı bir tarayıcıda yükleyin. Görüntü Modu denetimini kullanarak bağlanma moduna geçin. Posta Kodu Sağlayıcısı denetiminde fiiller menü okuna tıklayın ve sonra da bağlanma fiiline tıklayın. Sayfadaki bildirim temelli bağlantı nedeniyle zaten bağlı olan denetimlerin bağlantısını kesmek için Bağlantıyı Sonlandır düğmesine tıklayın. Sağlayıcının köprüyle bağlanması için bir tüketici seçin öğesine tıklayın ve çeşitli özellikleri ayarlamanın etkisine dikkat edin. Fare işaretçinizi Bağlan Denetimleri düğmesinin üzerine yerleştirirseniz, araç ipucunda özel açıklama metni görüntülenir.

Açıklamalar

Denetimle ConnectionsZone birlikte kullanılan bağlantı fiili, kullanıcıların iki denetim arasındaki bağlantıyı sonlandırdığı görünümün bir parçası olarak bağlantı kullanıcı arabiriminde (UI) görüntülenen bölge düzeyinde bir fiildir. Kullanıcı arabiriminin kullanıcıların bağlantı noktalarını seçebileceği bölümünde, iki denetim bağlanabiliyorsa, bağlantı fiili kullanıcı arabiriminin alt kısmına yakın bir yerde etkinleştirilir. Kullanıcılar bir bağlantı noktası seçtikten sonra bağlantı fiiline tıklayarak bağlantıyı oluşturabilirler.

Not

Bu konuda ele alınan bölge düzeyinde bağlantı fiili aslında denetimler arasında bir bağlantı kurar ve denetimin WebPart fiiller menüsünde görünen fiilden farklıdır. Kullanıcı bir Web sayfasını bağlantı görüntüleme moduna geçirirse, denetim bağlantı oluşturabiliyorsa fiil menüsünde bir WebPart bağlantı fiili görüntülenir. Bu WebPart bağlantı fiili, denetim tarafından oluşturulan bağlantı kullanıcı arabirimini ConnectionsZone açar. Buna karşılık, ConnectVerb bu konuda ele alınan ve bölge düzeyinde çalışan fiil aslında bir bağlantı oluşturur.

Kullanıcı arabiriminde ConnectVerb ilgili WebPartVerb nesneye başvuru almak için özelliğini kullanın. Özelliğin kendisi salt okunur olsa da, fiiline bir başvurunuz olduktan sonra, özellik değerlerini gerektiği gibi değiştirebilirsiniz.

Bir öğenin açma ve kapatma etiketleri arasında öğeyi bildirerek bağlantı fiilinin <connectverb> <asp:connectionszone> özellik değerlerini bildirimli olarak ayarlayabilirsiniz. Fiilin özellikleri, öğesinin açılış etiketi içinde bildirimli olarak da ayarlanabilir. Burada Subproperty Property-Subproperty, nesnesinin <asp:connectionszone> bir özelliğidir WebPartVerb (örneğin, ConnectVerb-Text). Ayrıca, özellikleri program aracılığıyla biçiminde Property.Subproperty de ayarlayabilirsiniz (örneğin, ConnectVerb.Text).

Şunlara uygulanır

Ayrıca bkz.

WebPartVerb

Aracılığıyla paylaş