ConnectionsZone.InstructionTitle プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文
Dim instance As ConnectionsZone Dim value As String value = instance.InstructionTitle instance.InstructionTitle = value
/** @property */ public String get_InstructionTitle () /** @property */ public void set_InstructionTitle (String value)
public function get InstructionTitle () : String public function set InstructionTitle (value : String)
接続 UI の指示タイトルを含んでいる文字列。既定のテキストは、.NET Framework によって提供される、カルチャ固有の文字列です。
InstructionTitle プロパティに含まれているテキストは、接続 UI が表示されて接続が既に存在する場合に常に表示されます。指示タイトルのテキストは、接続 UI の一番上にある (HeaderText プロパティに含まれている) ヘッダー テキストのすぐ下に表示されます。この指示タイトルは、既存の接続に参加しているコンシューマまたはプロバイダの WebPart コントロールに対して実行できるアクションの種類をユーザーに示す、一般的な説明です。既定では、指示タイトルは接続の管理で始まり、ユーザーがコントロールの動詞メニューで Connect 動詞をクリックして選択したコンシューマ コントロールまたはプロバイダ コントロールの名前で終わります。
メモ |
---|
このプロパティにカスタム値を割り当てるときは、接続を管理する対象としてプロバイダ コントロールとコンシューマ コントロールのどちらをユーザーが選択するかはデザイン時にはわからないという点に注意してください。そのため、カスタムの指示タイトルは、コンシューマ コントロールとプロバイダ コントロールの両方に言及する一般的な内容にする必要があります。これに対して、このプロパティの既定値は、ユーザーがコンシューマ コントロールとプロバイダ コントロールのどちらを選択した場合にも、その名前を動的に追加して表示されます。この動作を模倣するカスタム値をこのプロパティに使用するには、ConnectionsZone クラスから継承し、このプロパティまたは RenderBody メソッドをオーバーライドする必要があります。 |
このプロパティの値は、<asp:connectionszone> 要素の開始タグに InstructionTitle という名前の属性を追加してそれに値を割り当てることによって、宣言で設定できます。また、プログラムによってもプロパティ値を設定できます。
ConnectionsZone コントロールで InstructionTitle プロパティを使用するコード例を次に示します。この例には、Web ページの、このプロパティの使用方法を示すコードだけが含まれています。例を実行するために必要な他の 2 つのコード ファイルについては、ConnectionsZone クラスの概要の「使用例」を参照してください。コード例は、次の 4 つの部分から成ります。
-
Web ページ上の表示モードを切り替えられるようにするユーザー コントロール。このコードは、ConnectionsZone クラスの概要から取得してください。
-
ZIP Code インターフェイスのコード、および、接続のプロバイダとコンシューマとして機能する 2 つの WebPart コントロールのコードを含んでいるソース ファイル。このコードは、ConnectionsZone クラスの概要から取得してください。
-
すべてのコントロールをホストし、<asp:connectionszone> 要素を宣言し、プログラムによってプロパティを使用する方法を示す Web ページ。
この Web ページでは、<asp:connectionszone> 要素を宣言し、Page_PreRender メソッドで InstructionTitle プロパティに値を割り当てています。
<%@ 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 Consumer] コントロールの動詞メニューの矢印をクリックし、Connect 動詞をクリックします。既存の接続用に開かれたビューで、ヘッダー テキストのすぐ下にある指示タイトルが、コード例で InstructionTitle プロパティに割り当てた値になっていることを確認してください。
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.InstructionTitle プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からConnectionsZone.InstructionTitle プロパティを検索
- ConnectionsZone.InstructionTitle プロパティのページへのリンク