ConnectionsZone.ConnectVerb プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls.WebParts

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

2 つの 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

2 つのコントロールが接続を確立できるようにする WebPartVerb。

属性: PersistenceModeAttribute

例

次のコード例では、コントロールでプロパティを使用する ConnectVerb 方法を ConnectionsZone 示します。この例には、プロパティの使用を示す Web ページのコードのみが含まれています。この例を実行するために必要な他の 2 つのコードファイルについては、クラスの概要の「例」セクションを ConnectionsZone 参照してください。コード例には、次の 4 つの部分があります。

Web ページの表示モードを切り替えるユーザーコントロール。クラスの概要からこのコードを ConnectionsZone 取得します。
ZIP コードインターフェイスのコードと、接続のプロバイダーとコンシューマーとして機能する 2 つの WebPart コントロールを含むソースファイル。クラスの概要からこのコードを ConnectionsZone 取得します。
すべてのコントロールをホストし、要素を <asp:connectionszone> 宣言し、プロパティを宣言およびプログラムで使用する方法を示す Web ページ。
ブラウザーでの例の動作の説明。

Web ページは要素を <asp:connectionszone> 宣言し、要素タグ内で要素を宣言し、属性を <connectverb> 使用していくつかのプロパティを設定します。また、メソッドでは Page_PreRender 、コードはコントロールの接続動詞にいくつかのプロパティを 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 コントロール] ボタンの上にマウスポインターを置くと、カスタムの説明テキストがツールヒントに表示されます。

注釈

コントロールで ConnectionsZone 使用される connect 動詞は、ユーザーが 2 つのコントロール間の接続を最終処理するビューの一部として接続ユーザーインターフェイス (UI) に表示されるゾーンレベルの動詞です。ユーザーが接続ポイントを選択できる UI の部分で、2 つのコントロールが接続できる場合は、UI の下部付近で接続動詞が有効になります。ユーザーは接続ポイントを選択した後、接続動詞をクリックして接続を作成できます。

注意

このトピックで説明するゾーンレベルの接続動詞は、実際にはコントロール間の接続を確立し、コントロールの WebPart 動詞メニューに表示される動詞とは異なります。ユーザーが Web ページを接続して表示モードに切り替えると、コントロールが接続を形成できる場合は、 WebPart その動詞メニューに接続動詞が表示されます。この WebPart 接続動詞は、コントロールによって ConnectionsZone 作成された接続 UI を開くだけです。これに対し ConnectVerb 、ゾーンレベルで動作するこのトピックで説明する動詞は、実際には接続を作成します。

このプロパティを ConnectVerb 使用して、UI 内の対応する WebPartVerb オブジェクトへの参照を取得します。プロパティ自体は読み取り専用ですが、動詞への参照を取得した後は、必要に応じてプロパティ値を変更できます。

要素の開始タグと終了タグの間で要素を <connectverb> 宣言することで、connect 動詞のプロパティ値を <asp:connectionszone> 宣言によって設定できます。動詞のプロパティは、フォームに属性を追加することによって、要素の<asp:connectionszone>開始タグ内でProperty-Subproperty宣言的に設定することもできます。これはSubproperty、オブジェクトのWebPartVerbプロパティです (たとえば)。 ConnectVerb-Text フォームProperty.Subpropertyでプログラムでプロパティを設定することもできます (たとえば)。 ConnectVerb.Text

適用対象

こちらもご覧ください

WebPartVerb

ConnectionsZone.ConnectVerb プロパティ

定義

プロパティ値

例

注釈

適用対象

こちらもご覧ください

その他のリソース