Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe WebPartConnection

Fornece um objeto que permite que dois WebPart controles para formar uma conexão. Esta classe não pode ser herdada.

System.Object
  System.Web.UI.WebControls.WebParts.WebPartConnection

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

[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public sealed class WebPartConnection

O tipo WebPartConnection expõe os membros a seguir.

  NomeDescrição
Método públicoWebPartConnectionInicializa uma nova instância da classe WebPartConnection.
Superior

  NomeDescrição
Propriedade públicaConsumerObtém um WebPart o objeto que está agindo como o controle de consumidor em uma conexão.
Propriedade públicaConsumerConnectionPointObtém o objeto que serve como um ponto de conexão para um controle que atua como um consumidor em uma conexão.
Propriedade públicaConsumerConnectionPointIDObtém ou define o valor da propriedade em uma conexão que faz referência a identificação do objeto que serve como o ponto de conexão do consumidor para essa conexão.
Propriedade públicaConsumerIDObtém ou define o valor da propriedade em uma conexão que faz referência a identificação da WebPart controlar atuando como um consumidor para essa conexão.
Propriedade públicaIDObtém ou define a identificação de um WebPartConnection objeto.
Propriedade públicaIsActiveObtém um valor que indica se um WebPartConnection objeto está sendo estabelecida e é capaz de trocar dados entre o seus controles de provedor e consumidor.
Propriedade públicaIsSharedObtém um valor que indica se um WebPartConnection objeto está visível para todos os usuários ou somente para o usuário atual.
Propriedade públicaIsStaticObtém um valor que indica se um WebPartConnection objeto declarado na marcação de uma página da Web ou criado por programação.
Propriedade públicaProviderObtém um WebPart controle que atua como o provedor em uma conexão de Web Parts.
Propriedade públicaProviderConnectionPointObtém o objeto que serve como um ponto de conexão para um WebPart controlar atuando como um provedor para uma conexão.
Propriedade públicaProviderConnectionPointIDObtém ou define o valor da propriedade em uma conexão que faz referência a identificação do objeto que serve como o ponto de conexão do provedor para essa conexão.
Propriedade públicaProviderIDObtém ou define o valor da propriedade em uma conexão que faz referência a identificação da WebPart controlar atuando como um provedor para essa conexão.
Propriedade públicaTransformerObtém um WebPartTransformer objeto que é usado para transformar dados entre dois pontos de conexão normalmente incompatíveis em uma conexão de Web Parts.
Propriedade públicaTransformersInfraestrutura. Obtém uma coleção de WebPartTransformer objetos usados internamente pelo conjunto de controle de Web Parts.
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoToStringSubstitui o herdadas ToString método e retorna o nome de um tipo de curto para o objeto de conexão. (Substitui Object.ToString().)
Superior

No conjunto de controle de Web Parts, uma conexão é um link ou uma associação entre duas WebPart (ou outro servidor ou usuário) controles que permitir que eles compartilhem dados. Essa capacidade de compartilhar dados permite que os controles conectados a serem usados de maneiras que excedem a funcionalidade oferecida pelos controles isolados. Por exemplo, se um controle fornece dados de CEP e outro controle pode ler esses dados e fornecer informações de previsão do tempo com base no CEP, o recurso conectado dos dois controles oferece mais valor para os usuários. Para estender este exemplo, foi possível criar outros controles que também exibir informações com base em um código postal, como, por exemplo, um controle com links para notícias locais, e todos esses controles podem trabalhar com dados de código postal podem compartilhar dados com o único controle que fornece um código postal. Os usuários finais dos aplicativos de Web Parts pode criar e gerenciar conexões entre todos os controles diretamente a partir de um navegador da Web, usando a interface de usuário (UI) conexões padrão fornecida pelo tais compatíveis a ConnectionsZone controle ou usando uma interface do usuário personalizado fornecido pelo desenvolvedor.

Isso WebPartConnection visão geral da classe é uma declaração geral dos detalhes básicos para criar uma conexão. Para obter mais informações sobre componentes específicos e os requisitos envolvidos na criação de conexões, consulte Web Parts Connections Overview, ou consulte as classes de referência e o código exemplos mencionados na discussão a seguir. Há vários aspectos fundamentais de uma conexão de Web Parts:

  • Dois controles WebPart. Todas as conexões de Web Parts contém em dois controles. É possível que um controle participar de mais de uma conexão ao mesmo tempo, mas cada conexão única consiste exatamente dois controles. Os controles podem ser obtidos diretamente com o WebPart classe base, ou eles podem ser outros controles de servidor ASP.NET, controles de servidor personalizados e controles de usuário. Controles que não derivam o WebPart de classe, se colocado em um WebPartZoneBase da zona, automaticamente são empacotados com um GenericWebPart objeto em tempo de execução, o que permite que eles herdam o WebPart classe e a função como o tempo de execução WebPart controles.

  • Controles que residem em WebPartZoneBase zonas. Ambos WebPart controles e qualquer outro tipo de controle de servidor devem residir em um WebPartZoneBase zona para poder participar de conexões de Web Parts (e a maioria dos outros recursos de Web Parts).

  • Os consumidores e provedores. Há dois controles em cada conexão de Web Parts: um provedor de dados e um consumidor de dados. O provedor fornece dados para o consumidor através de um método de retorno de chamada especificada que retorna dados na forma de uma interface. (Para obter um exemplo de como criar e especificar o método de retorno de chamada, consulte a seção exemplo neste tópico). Esse método de retorno de chamada é conhecido como um ponto de conexão do provedor. Os detalhes desse ponto de conexão (seu nome "amigável", uma ID e o tipo da interface retornada) estão contidos em um ProviderConnectionPoint objeto associado com o controle do provedor. O consumidor recebe os dados por meio de um método especificado que pode aceitar uma instância da interface. Esse método é conhecido como um ponto de conexão do consumidor e os detalhes do ponto de conexão (nome, identificação e tipo de interface) estão contidos em um ConsumerConnectionPoint objeto associado com o controle do consumidor.

  • Controles compatíveis ou um transformador válido. Para uma conexão funcionar, o consumidor e provedor devem ser compatível com (que significa que os seus métodos de ponto de conexão especificada podem trabalhar com o mesmo tipo de interface), ou ser necessário uma WebPartTransformer objeto capaz de converter o tipo oferecido pelo fornecedor em um tipo entendido pelo cliente.

  • A WebPartConnection object. Para uma conexão existir, deve haver uma instância de WebPartConnection classe que contém referências para os controles do provedor e consumidor, juntamente com os detalhes de seus pontos de conexão. Se o provedor e consumidor são incompatíveis e usar um WebPartTransformer o objeto para se conectar, a conexão faz referência o transformador.

  • Um meio de estabelecer a conexão. Depois de controles de consumidor e provedor compatíveis foram adequadamente projetados com métodos de ponto de conexão e colocados em uma zona e um WebPartConnection o objeto está disponível, é de última etapa básicas necessárias iniciar a conexão. Isso pode acontecer de uma maneira é para usuários criar a conexão através da interface do usuário. Se você colocar um <asp:connectionszone> elemento na página e o outro necessário componentes de uma conexão estão no lugar, em tempo de execução, um usuário pode alternar a página no modo de exibição de conectar, clique um verbo de conectar-se no menu de verbos do provedor ou consumidor e uma conexão da interface do usuário (com base na ConnectionsZone controle) será exibida. Por meio da interface de usuário, o usuário pode iniciar a conexão. Outra maneira para iniciar a conexão é fazê-lo por meio de programação. Em ambos os casos, se, por meio da interface do usuário ou através de programação, o método subjacente que inicia a conexão é o mesmo. O aplicativo chama o ConnectWebParts método (ou o ConnectWebParts método se usando um transformador) sobre o WebPartManager controlar, passando-lhe o provedor, o consumidor e seus objetos de ponto de conexão com a respectiva, e o método retorna um WebPartConnection objeto.

O WebPartConnection classe define um objeto que encapsula os detalhes essenciais de uma conexão entre dois WebPart controles. A classe consiste quase inteiramente propriedades relacionadas aos detalhes de uma determinada conexão. Várias propriedades se referem a controle consumidor em uma conexão. O Consumer propriedade referencia o controle de consumidor propriamente dito e o ConsumerID propriedade faz referência a identificação de. do consumidor O ConsumerConnectionPoint o objeto, que contém os detalhes do ponto de conexão do consumidor, é referenciado pelo consumidor de ConsumerConnectionPoint propriedade. O ConsumerConnectionPointID propriedade faz referência a identificação da ConsumerConnectionPoint objeto. Todas essas propriedades relacionadas ao consumidor de conexão devem ter um valor atribuído a eles para criar uma conexão.

O WebPartConnection classe também tem várias propriedades que se relacionam com o controle do provedor em uma conexão, e elas correspondem às propriedades para um consumidor. O Provider propriedade referencia o controle provedor propriamente dito, enquanto o ProviderID propriedade faz referência a sua identificação. O ProviderConnectionPoint referências de propriedade da ProviderConnectionPoint objeto e o ProviderConnectionPointID propriedade faz referência a identificação de ponto de conexão do provedor.

Várias propriedades interessam o estado da conexão. O IsActive propriedade indica se a conexão está ativa (atualmente troca de dados) ou inativos (ainda conectados mas não ativamente compartilhamento dados). O IsShared propriedade indica se a conexão é compartilhada (disponível para todos os usuários de uma página) ou uma conexão específica do usuário e o IsStatic propriedade indica se o controle é estático (declarado na marcação da página e, portanto, permanente) ou dinâmicos (criado através de programação, o que significa que pode ser excluída).

O exemplo de código a seguir demonstra como criar uma conexão simples entre dois WebPart controles. O exemplo demonstra três maneiras de formar uma conexão: declarativamente, colocando as marcas para a conexão na marcação da página da Web; programaticamente, criando a conexão no código; e por meio da interface do usuário, colocando um ConnectionsZone o controle na página, que permite aos usuários estabelecer uma conexão.

O exemplo de código tem quatro partes:

  • Modo de exibição de um controle de usuário que permite que você altere a Web Parts em uma página.

  • O código para uma interface e duas fonte WebPart controla atuando como o provedor e consumidor para uma conexão.

  • Uma página da Web para hospedar todos os controles e executar o exemplo de código.

  • Uma explicação de como executar a página de exemplo.

A primeira parte deste exemplo de código é o controle de usuário que permite aos usuários alterar modos de exibição em uma página da Web. Salve o seguinte código-fonte para um arquivo. ascx, dando a ele o nome do arquivo que é atribuído ao Src atributo da Register diretiva para este controle de usuário, que é próxima à parte superior da página da Web de hospedagem. Para obter detalhes sobre como exibem modos e uma descrição de código-fonte nesse controle, consulte Walkthrough: Changing Display Modes on a Web Parts Page.


<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">

 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }

  }

  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>


A segunda parte do exemplo de código é o código-fonte da interface e controles. O arquivo de origem contém uma interface simples chamada IZipCode. Há também um WebPart classe chamada ZipCodeWebPart que implementa a interface e atua como o controle de provedor. Sua ProvideIZipCode é o método de retorno de chamada que implementa o membro de apenas da interface. O método simplesmente retorna uma instância da interface. Observe que o método está marcado com um ConnectionProvider atributo nos metadados. Esse é o mecanismo para identificar o método como o método de retorno de chamada para o ponto de conexão do provedor. O outro WebPart classe é nomeada WeatherWebPart, e ele atua como o consumidor da conexão. Essa classe tem um método chamado GetZipCode que obtém uma instância da IZipCode interface a partir do controle do provedor. Observe que esse método está marcado como método de ponto de conexão do consumidor com um ConnectionConsumer atributo nos metadados.

Para o exemplo de código para ser executado, você deve compilar este código-fonte. Você pode compilá-lo explicitamente e colocar o assembly resultante na pasta Bin do seu site da Web ou o cache de assembly global. Alternativamente, você pode colocar o código-fonte na pasta App_Code do seu site, onde será compilado dinamicamente em tempo de execução. Este exemplo de código usa compilação dinâmica. Para uma explicação passo a passo que demonstre como compilar, consulte Walkthrough: Developing and Using a Custom Server Control.


namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code Provider", "ZipCodeProvider")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (input.Text != String.Empty)
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }

  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }

    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }

  }
}


A terceira parte do exemplo de código é a página da Web. Na parte superior são os Register diretivas para o controle de usuário e personalizado WebPart controles. Porque o exemplo supõe que a compilação dinâmica dos controles, o código-fonte para os controles deve ser em uma subpasta App_Code; o Register marca na página faz referência a um prefixo de marca arbitrário e o espaço para nome dos controles. Custom WebPart (o provedor e consumidor) de controles são declarados dentro da página da Web <asp:webpartzone> elemento, dentro um <zonetemplate> elemento.

A página fornece três maneiras para formar uma conexão entre os controles personalizados. O primeiro método é declarativo. Na marcação para a página, um <StaticConnections> elemento é declarado e dentro do que é um <asp:WebPartConnections> elemento, com os diversos detalhes de consumidor e provedor da conexão especificadas como atributos. Esta é uma maneira de criar uma conexão, declarando-o diretamente na página da Web, especificamente dentro do <asp:WebPartManager> elemento. Devido a essa conexão estática, de uma conexão entre os dois controles personalizados é criada imediatamente na primeira vez que a página for carregada.

Um segundo método para formar uma conexão entre os controles é fornecido pelo <asp:connectionszone> elemento na página. Se um usuário alterna uma página no modo de exibição de conectar-se em tempo de execução e clica em um verbo de conectar-se em um dos controles personalizados, o <asp:connectionszone> elemento processa automaticamente a interface do usuário para criar uma conexão.

A página também demonstra uma terceira forma de criar uma conexão, que é fazer isso programaticamente. No Button1_Click método, o código cria um ProviderConnectionPoint o objeto para o controle provedor e recupera seu ponto de conexão detalha chamando o GetProviderConnectionPoints método. Ele executa uma tarefa semelhante para o controle do consumidor, chamando o GetConsumerConnectionPoints método. Finalmente, ele cria o novo WebPartConnection objeto chamando o ConnectWebParts método na WebPartManager 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 Button1_Click(object sender, EventArgs e)
  {
    ProviderConnectionPoint provPoint = 
      mgr.GetProviderConnectionPoints(zip1)["ZipCodeProvider"];
    ConsumerConnectionPoint connPoint = 
      mgr.GetConsumerConnectionPoints(weather1)["ZipCodeConsumer"];
    WebPartConnection conn1 = mgr.ConnectWebParts(zip1, provPoint,
      weather1, connPoint);
  }

  protected void mgr_DisplayModeChanged(object sender, 
    WebPartDisplayModeEventArgs e)
  {
    if (mgr.DisplayMode == WebPartManager.ConnectDisplayMode)
      Button1.Visible = true;
    else
      Button1.Visible = false;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" 
    OnDisplayModeChanged="mgr_DisplayModeChanged">
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1"
            ProviderConnectionPointID="ZipCodeProvider"
            ProviderID="zip1" />
        </StaticConnections>
      </asp:WebPartManager>
      <uc1:DisplayModeMenuCS ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" 
    Visible="false" />
    </div>
    </form>
</body>
</html>


Depois de carregar a página da Web em um navegador, a primeira conexão já existe porque ela é declarada dentro de <StaticConnections> elemento. Digite algum texto no Provedor de CEP controle e ele serão exibido no controle do consumidor. Em seguida, desconecte os dois controles. Usando o O modo de exibição drop-down list de controle, alterar a página para conectar-se o modo de exibição. Clique no menu de verbos (representado por uma seta para baixo na barra de título) para cada um do WebPart controla e observe que cada um tem um Connect opção. Este é um verbo de conexão, que aparece no menu de verbos apenas quando a página estiver no modo de conexão. Clique no verbo de conectar-se em um dos controles e a conexão da interface do usuário fornecida pelo ConnectionsZone controle aparece. Clique no desconexão para encerrar a conexão estática entre os controles. Use o Modo de exibição controle para retornar a página ao modo Procurar. Tente inserir um novo texto no provedor novamente e observe que, porque os controles são desconectados, o texto Falha ao atualizar no controle do consumidor.

Em seguida, use o mesmo método acima para alternar a página no modo de exibição de conectar-se novamente. Clique em um verbo de conectar-se em um dos controles. Clique no criar uma conexão link e, em seguida, use a interface do usuário fornecida pelo ConnectionsZone o controle para criar uma conexão entre os controles. Este é o segundo método para criar uma conexão. Observe que, assim que a conexão for formada, a última seqüência de caracteres digitada no controle do provedor (o que não é possível exibir porque os controles foram desconectados) aparece repentinamente no consumidor, porque a conexão foi criado novamente. Clique no desconexão para encerrar a conexão atual que você acabou de criar. Retorne a página ao modo Procurar. Digite um novo texto no provedor para demonstrar que o texto não é atualizado e que os controles são desconectados de novamente.

Retorne a página para conectar o modo de exibição. Em vez de clicar em um verbo de conectar, clique o Conectar controles de Web Part botão, que ilustra o terceiro método de formar uma conexão. Essa abordagem conecta os controles por meio de programação em uma etapa simples sem ter que usar o ConnectionsZone controle. Observe que, como a conexão é criada, a última seqüência de caracteres que você inseriu no provedor de repente aparece no controle do consumidor.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft