ConnectionsZone.InstructionTitle Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta il testo utilizzato per una descrizione generale dell'azione che può essere eseguita nel controllo consumer o provider con l'interfaccia utente di connessione per la gestione delle connessioni esistenti.

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

Valore della proprietà

String

Stringa che contiene il titolo di un'istruzione per l'interfaccia utente di connessione. Il testo predefinito è una stringa specifica delle impostazioni cultura fornita in .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della InstructionTitle proprietà con un ConnectionsZone controllo . L'esempio contiene solo il codice per la pagina Web che illustra l'uso della proprietà ; per gli altri due file di codice necessari per eseguire l'esempio, vedere la sezione Esempio della panoramica della ConnectionsZone classe. L'esempio di codice ha quattro parti:

  • Controllo utente che consente di cambiare modalità di visualizzazione nella pagina Web. Ottenere questo codice dalla panoramica della ConnectionsZone classe.

  • Un file di origine che contiene il codice per un'interfaccia zip code e due WebPart controlli che fungono da provider e consumer per una connessione. Ottenere questo codice dalla panoramica della ConnectionsZone classe.

  • Una pagina Web che ospita tutti i controlli, dichiara un <asp:connectionszone> elemento e mostra come usare la proprietà a livello di codice.

  • Spiegazione del funzionamento dell'esempio in un browser.

La pagina Web dichiara un <asp:connectionszone> elemento e, nel metodo , il Page_PreRender codice assegna un valore alla InstructionTitle proprietà .

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

Caricare la pagina in un browser. Passare alla modalità di connessione usando il controllo Modalità di visualizzazione . Fare clic sulla freccia del menu verbi nel controllo Consumer zip code e fare clic sul verbo di connessione. Nella visualizzazione che si apre per la connessione esistente, si noti che il titolo dell'istruzione appena sotto il testo dell'intestazione, nella parte superiore della zona connessioni, è il valore assegnato alla InstructionTitle proprietà nell'esempio di codice.

Commenti

Il testo contenuto nella InstructionTitle proprietà è visibile ogni volta che viene visualizzata l'interfaccia utente della connessione e esiste già una connessione. Il testo del titolo dell'istruzione si trova appena sotto il testo dell'intestazione (contenuto nella HeaderText proprietà ), disponibile nella parte superiore dell'interfaccia utente della connessione. Il titolo dell'istruzione è una descrizione generale che informa gli utenti del tipo di azione che può essere eseguita sul controllo consumer o provider WebPart che partecipa a una connessione esistente. Per impostazione predefinita, il titolo dell'istruzione inizia con Gestisci le connessioni per e termina con il nome del consumer o del controllo del provider selezionato dall'utente facendo clic sul verbo di connessione nel menu dei verbi.

Nota

Quando si assegna un valore personalizzato a questa proprietà, tenere presente che non è possibile sapere in fase di progettazione se l'utente selezionerà un provider o un controllo consumer su cui gestire la connessione, pertanto il titolo dell'istruzione personalizzata deve essere sufficientemente generale da fare riferimento a un consumer o a un controllo provider. Al contrario, viene eseguito il rendering del valore predefinito della proprietà in modo che accoda dinamicamente il nome di qualsiasi controllo consumer o provider selezionato dall'utente. Se si desidera fornire un valore personalizzato per la proprietà che simula questo comportamento, è necessario ereditare dalla classe ed eseguire l'override ConnectionsZone di questa proprietà o del RenderBody metodo .

È possibile impostare il valore di questa proprietà in modo dichiarativo all'interno del tag di apertura dell'elemento <asp:connectionszone> aggiungendo un attributo denominato InstructionTitle e assegnando un valore. È anche possibile impostare il valore della proprietà a livello di codice.

Si applica a

Vedi anche