ConnectionsZone.CloseVerb Propriedade

Referência

Definição

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

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais fechar a IU (interface do usuário) de conexão criada pelo controle ConnectionsZone.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valor da propriedade

WebPartVerb

Um WebPartVerb que permite que um usuário final feche a interface do usuário da conexão.

Atributos: PersistenceModeAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da CloseVerb propriedade com um ConnectionsZone controle. O exemplo contém apenas o código para a página da Web que demonstra o uso da propriedade; para os outros dois arquivos de código necessários para executar o exemplo, consulte a seção Exemplo da visão geral da ConnectionsZone classe. O exemplo de código tem quatro partes:

Um controle de usuário que permite alternar os modos de exibição na página da Web. Obtenha esse código da visão geral da ConnectionsZone classe.
Um arquivo de origem que contém o código para uma interface de CEP e dois WebPart controles que atuam como o provedor e o consumidor de uma conexão. Obtenha esse código da visão geral da ConnectionsZone classe.
Uma página da Web que hospeda todos os controles, declara um <asp:connectionszone> elemento e mostra como usar a propriedade de forma declarativa e programática.
Uma explicação de como o exemplo funciona em um navegador.

A página da Web declara um <asp:connectionszone> elemento e, dentro do elemento, declara um <closeverb> elemento e define uma propriedade usando atributos. Além disso, no Page_PreRender método, o código define uma propriedade no verbo de fechamento para o ConnectionsZone controle.

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

Carregue a página em um navegador. Alterne para o modo de conexão, usando o controle Modo de Exibição . Clique na seta do menu de verbos no controle provedor de CEP e clique no verbo de conexão. Clique no botão Encerrar Conexão para desconectar os controles que já estão conectados devido à conexão declarativa na página. Clique em Selecionar um consumidor para que o provedor se conecte com o hiperlink e observe o efeito de definir as várias propriedades. Se você posicionar o ponteiro do mouse sobre o botão Fechar Zona na parte inferior da interface do usuário da conexão, o texto de descrição personalizado aparecerá em uma Dica de Ferramenta. Observe que o verbo de fechamento do cabeçalho na parte superior da zona de conexões é representado por um hiperlink e suas atribuições de propriedade no verbo de fechamento não têm efeito no verbo de fechamento do cabeçalho.

Comentários

O verbo de fechamento, conforme usado com um ConnectionsZone controle, é um verbo de nível de zona que aparece na parte inferior (o rodapé) da interface do usuário da conexão. Quando os usuários clicam no verbo de fechamento, ele cancela o processo de conexão e fecha a interface do usuário da conexão, mas deixa a página no modo de exibição de conexão. Neste ponto, o usuário pode retornar a página para navegar no modo ou clicar no verbo de conexão em outro controle de servidor para reabrir a interface do usuário da conexão.

O verbo de fechamento deve ser diferenciado do verbo de fechamento do cabeçalho (para obter detalhes, consulte a HeaderCloseVerb propriedade). Ambos os verbos executam a ação idêntica de fechar a interface do usuário da conexão, mas o verbo de fechamento do cabeçalho aparece na parte superior da interface do usuário e é representado por um hiperlink por padrão, enquanto o verbo de fechamento aparece na parte inferior da interface do usuário e é representado por um botão por padrão.

Use a CloseVerb propriedade para obter uma referência ao objeto correspondente WebPartVerb na interface do usuário. Embora a propriedade em si seja somente leitura, depois que você tiver uma referência ao verbo, você poderá alterar seus valores de propriedade conforme necessário.

Você pode definir os valores de propriedade do verbo de fechamento declarativamente, declarando o <closeverb> elemento dentro das marcas de um <asp:connectionszone> elemento. As propriedades do verbo podem ser definidas declarativamente no formulário Property-Subproperty, onde Subproperty está uma propriedade do WebPartVerb objeto (por exemplo, CloseVerb-Text). Você também pode definir as propriedades programaticamente no formulário Property.Subproperty (por exemplo, CloseVerb.Text).

Aplica-se a

Compartilhar via