ConnectionsZone.InstructionTitle Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den als allgemeine Beschreibung der Aktion verwendeten Text ab oder legt ihn fest, der im Consumer- oder Anbietersteuerelement innerhalb der Benutzeroberfläche für Verbindungen zum Verwalten von bestehenden Verbindungen ausgeführt werden kann.

public:
 virtual property System::String ^ InstructionTitle { System::String ^ get(); void set(System::String ^ value); };

public virtual string InstructionTitle { get; set; }

member this.InstructionTitle : string with get, set

Public Overridable Property InstructionTitle As String

Eigenschaftswert

String

Eine Zeichenfolge, die den Anweisungstitel für die Benutzeroberfläche für Verbindungen enthält. Der Standardtext ist eine von .NET Framework bereitgestellte kulturspezifische Zeichenfolge.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der InstructionTitle Eigenschaft mit einem ConnectionsZone Steuerelement veranschaulicht. Das Beispiel enthält nur den Code für die Webseite, die die Verwendung der Eigenschaft veranschaulicht; für die anderen beiden Codedateien, die zum Ausführen des Beispiels erforderlich sind, finden Sie im Abschnitt "Beispiel" der ConnectionsZone Klassenübersicht. Das Codebeispiel weist vier Teile auf:

Ein Benutzersteuerelement, mit dem Sie Anzeigemodi auf der Webseite wechseln können. Rufen Sie diesen Code aus der ConnectionsZone Klassenübersicht ab.
Eine Quelldatei, die den Code für eine POSTLEITZAHL-Schnittstelle enthält, und zwei WebPart Steuerelemente, die als Anbieter und Verbraucher für eine Verbindung fungieren. Rufen Sie diesen Code aus der ConnectionsZone Klassenübersicht ab.
Eine Webseite, die alle Steuerelemente hostet, ein <asp:connectionszone> Element deklariert und zeigt, wie die Eigenschaft programmgesteuert verwendet wird.
Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Die Webseite deklariert ein <asp:connectionszone> Element, und in der Page_PreRender Methode weist der Code der InstructionTitle Eigenschaft einen Wert zu.

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

Laden Sie die Seite in einem Browser. Wechseln Sie zum Verbindungsmodus mithilfe des Anzeigemodus-Steuerelements . Klicken Sie auf den Menüpfeil "Verben" im POSTLEITZAHL-Verbrauchersteuerelement , und klicken Sie auf das Verbindungsverb. Beachten Sie in der Ansicht, die für die vorhandene Verbindung geöffnet wird, dass der Anweisungstitel direkt unterhalb des Kopfzeilentexts im oberen Bereich der Verbindungszone der Wert ist, der der InstructionTitle Eigenschaft im Codebeispiel zugewiesen ist.

Hinweise

Der in der InstructionTitle Eigenschaft enthaltene Text ist sichtbar, wenn die Verbindungsbenutzeroberfläche angezeigt wird und eine Verbindung bereits vorhanden ist. Der Anweisungstiteltext befindet sich direkt unterhalb des Kopfzeilentexts (in der HeaderText Eigenschaft enthalten), der oben auf der Verbindungsbenutzeroberfläche gefunden wird. Der Titel der Anweisung ist eine allgemeine Beschreibung, in der Benutzer darüber informiert werden können, welche Art von Aktion auf dem Verbraucher- oder Anbietersteuerelement WebPart ausgeführt werden kann, das an einer vorhandenen Verbindung teilnimmt. Standardmäßig beginnt der Anweisungstitel mit "Verbindungen verwalten" und endet mit dem Namen des Consumer- oder Anbietersteuerelements, das der Benutzer ausgewählt hat, indem er im Menü "Verben" auf das Verbindungsverb klickt.

Hinweis

Wenn Sie dieser Eigenschaft einen benutzerdefinierten Wert zuweisen, denken Sie daran, dass Sie zur Entwurfszeit nicht wissen können, ob der Benutzer einen Anbieter oder ein Verbrauchersteuerelement auswählt, auf den die Verbindung verwaltet werden soll, sodass der titel der benutzerdefinierten Anweisung allgemein genug sein muss, um auf einen Verbraucher oder ein Anbietersteuerelement zu verweisen. Im Gegensatz dazu wird der Standardwert der Eigenschaft so gerendert, dass er dynamisch den Namen eines beliebigen Verbrauchers oder Anbietersteuerelements angibt, das der Benutzer auswählt. Wenn Sie einen benutzerdefinierten Wert für die Eigenschaft angeben möchten, die dieses Verhalten nachahmt, müssen Sie von der ConnectionsZone Klasse erben und diese Eigenschaft oder die RenderBody Methode außer Kraft setzen.

Sie können den Wert dieser Eigenschaft deklarativ innerhalb des öffnenden Tags des <asp:connectionszone> Elements festlegen, indem Sie ein Attribut namens InstructionTitle hinzufügen und ihm einen Wert zuweisen. Sie können den Eigenschaftswert auch programmgesteuert festlegen.

Gilt für

Siehe auch

InstructionText

Freigeben über