ConnectionsZone.ConfigureVerb プロパティ
アセンブリ: System.Web (system.web.dll 内)

接続 UI の接続の構成セクションを開くために使用する WebPartVerb。

Configure 動詞は、接続が既に存在する場合にユーザーが接続 UI を開いたときに、接続 UI の接続の管理セクションに表示されます。UI には、接続を終了する [End Connection] と、接続を構成する (Configure 動詞を表す) [Configure] が表示されます。ユーザーが [Configure] をクリックすると、UI に、ユーザーが接続を構成できる接続の構成セクションが表示されます。接続を構成するこのオプション ([Configure] ボタン) は、接続にトランスフォーマが使用され、トランスフォーマにユーザーが接続を構成できる構成ウィザード コントロール (Wizard) が含まれている場合にのみ有効になります。詳細については、WebPartTransformer クラスのトピックを参照してください。
ConfigureVerb プロパティは、UI の対応する WebPartVerb オブジェクトへの参照を取得するために使用します。このプロパティ自体は読み取り専用ですが、動詞への参照を取得した後は、必要に応じてプロパティ値を変更できます。
Configure 動詞のプロパティ値は、<asp:connectionszone> 要素のタグの中で <configureverb> 要素を宣言することにより、宣言で設定できます。この動詞のプロパティは、Property-Subproperty の形式で宣言によって設定できます。ここで、Subproperty は WebPartVerb オブジェクトのプロパティを表します (例 : ConfigureVerb-Text)。また、このプロパティは、Property.Subproperty の形式でプログラムによって設定することもできます (例 : ConfigureVerb.Text)。

ConnectionsZone コントロールで ConfigureVerb プロパティを使用するコード例を次に示します。この例には、Web ページの、このプロパティの使用方法を示すコードだけが含まれています。例を実行するために必要な他の 2 つのコード ファイルについては、ConnectionsZone クラスの概要の「使用例」を参照してください。コード例は、次の 4 つの部分から成ります。
-
Web ページ上の表示モードを切り替えられるようにするユーザー コントロール。このコードは、ConnectionsZone クラスの概要から取得してください。
-
ZIP Code インターフェイスのコード、および、接続のプロバイダとコンシューマとして機能する 2 つの WebPart コントロールのコードを含んでいるソース ファイル。このコードは、ConnectionsZone クラスの概要から取得してください。
-
すべてのコントロールをホストし、<asp:connectionszone> 要素を宣言し、宣言およびプログラムによってプロパティを使用する方法を示す Web ページ。
この Web ページでは、<asp:connectionszone> 要素を宣言し、この要素内で <configureverb> 要素を宣言し、属性を使用して 1 つのプロパティを設定しています。また、Page_PreRender メソッドでも、ConnectionsZone コントロールの Configure 動詞の 1 つのプロパティを設定しています。
<%@ 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 > <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>
<%@ 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 > <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>
ブラウザにページを読み込みます。[表示モード] コントロールを使用して、接続モードに切り替えます。[ZIP Code Provider] コントロールの動詞メニューの矢印をクリックし、Connect 動詞をクリックします。既に接続されているコントロールの接続を解除する [End Connection] と、無効状態の [Configure] が表示されることに注意してください。コード例が構成ウィザードを含んだトランスフォーマを使用していれば、[Configure] が有効になり、ユーザーはそれをクリックして接続を構成できます。接続 UI の [Configure] ボタン上にマウス ポインタを置くと、ツールヒントにカスタムの説明テキストが表示されます。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Weblioに収録されているすべての辞書からConnectionsZone.ConfigureVerb プロパティを検索する場合は、下記のリンクをクリックしてください。

- ConnectionsZone.ConfigureVerb プロパティのページへのリンク