Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade ConnectionsZone.NoExistingConnectionInstructionText

Obtém ou define o texto de instrução que aparece no corpo da conexão de interface do usuário (UI) quando um controle de Web Parts não tem nenhuma conexão existente.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web.dll)

public virtual string NoExistingConnectionInstructionText { get; set; }
<asp:ConnectionsZone NoExistingConnectionInstructionText="String" />

Valor de propriedade

Tipo: System.String
Uma seqüência de caracteres que contém a mensagem de texto para o caso onde não há nenhuma conexão existente.O texto padrão é uma seqüência de caracteres específicos de cultura fornecida pelo .NET estrutura.

O texto contido no NoExistingConnectionInstructionText a propriedade é visível sempre que a conexão de interface do usuário é exibida e nenhuma conexão existir. Depois que um usuário alterna uma página no modo de exibição de conectar e clica em um verbo de conectar no menu de verbos de um WebPart controle, a conectar principal da interface do usuário é exibido. Se não houver nenhuma conexão corrente, o texto a partir de NoExistingConnectionInstructionText propriedade é exibida na parte inferior da conexão da interface do usuário, logo acima o verbo de fechar na área de rodapé da zona. O texto descreve o fato de que não existem conexões existentes e oferece aos usuários instruções básicas para criar uma conexão na interface do usuário.

Você pode conjunto o valor desta propriedade declarativamente dentro da marca de abertura do <asp:connectionszone> elemento, adicionando um atributo chamado NoExistingConnectionInstructionText e atribuir a ele um valor. Você também pode conjunto o valor da propriedade programaticamente.

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

  • Um controle de usuário que permite que você alterne os modos de exibição na página da Web.Obter esse código do ConnectionsZone Visão geral da classe.

  • A arquivo de fonte que contém o código para uma interface de CEP e dois WebPart controles que atua sistema autônomo o provedor e consumidor para uma conexão. Obter esse código do ConnectionsZone Visão geral da classe.

  • Uma página da Web que hospeda todos os controles, declara um <asp:connectionszone> elemento e mostra como usar a propriedade programaticamente.

  • Uma explicação de como o exemplo funciona em um navegador.

A página da Web declara um <asp:connectionszone> elemento e, na Page_PreRender método, o código atribui um valor para o NoExistingConnectionInstructionText propriedade.

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

  protectedvoid 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>


Carregar a página em um navegador. comutador para conectar-se o modo, usando o Modo de exibição controle.clicar na seta do menu de verbos no Consumidor de CEP controle e clicar no verbo de conectar.No modo de exibição que é aberta para a conexão existente, clicar no Conexão de participante botão.Observe que o texto de instrução para nenhuma conexão existente aparece na parte inferior da conexão da interface do usuário, logo acima o verbo de fechar na área de rodapé da zona.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0
Mostrar: