Bagikan melalui


ConnectionsZone Kelas

Definisi

Menyediakan antarmuka pengguna (UI) yang memungkinkan pengguna membentuk koneksi antara WebPart dan kontrol server lain yang berada di WebPartZoneBase zona.

public ref class ConnectionsZone : System::Web::UI::WebControls::WebParts::ToolZone
public class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZone
type ConnectionsZone = class
    inherit ToolZone
Public Class ConnectionsZone
Inherits ToolZone
Warisan

Contoh

Contoh kode berikut menunjukkan cara menggunakan ConnectionsZone kontrol pada halaman Bagian Web. Contohnya memiliki empat bagian:

  • Kontrol pengguna yang memungkinkan Anda beralih mode tampilan pada halaman Web.

  • File sumber yang berisi kode untuk antarmuka Kode Pos, dan dua WebPart kontrol yang bertindak sebagai penyedia dan konsumen untuk koneksi.

  • Halaman Web yang menghosting semua kontrol, menunjukkan cara mendeklarasikan <asp:connectionszone> elemen, dan mengatur sejumlah properti pada zona koneksi secara deklaratif dan terprogram.

  • Penjelasan tentang cara kerja contoh di browser.

Bagian pertama dari contoh kode ini adalah kontrol pengguna yang memungkinkan pengguna untuk beralih mode tampilan pada halaman Web. Untuk detail tentang mode tampilan dan deskripsi kode sumber dalam kontrol ini, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.

<%@ 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=" 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>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' 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 Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</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=" 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>

Bagian kedua dari contoh adalah file sumber dengan antarmuka dan kontrol kustom. Perhatikan bahwa ZipCodeWebPart kontrol mengimplementasikan IZipCode antarmuka, menambahkan ConnectionProvider atribut sehingga kontrol dapat bertindak sebagai penyedia untuk koneksi. Kontrol WeatherWebPart memiliki metode yang ditandai dengan ConnectionConsumer atribut , di mana ia menggunakan IZipCode antarmuka, sehingga dapat bertindak sebagai konsumen dalam koneksi.

Agar contoh kode berjalan, Anda harus mengkompilasi kode sumber ini. Anda dapat mengkompilasinya secara eksplisit dan meletakkan rakitan yang dihasilkan di folder Bin situs Web Anda atau cache perakitan global. Atau, Anda dapat meletakkan kode sumber di folder App_Code situs Anda, di mana kode tersebut akan dikompilasi secara dinamis pada durasi. Contoh ini menggunakan kompilasi dinamis. Untuk panduan yang menunjukkan cara mengkompilasi, lihat Panduan: Mengembangkan dan Menggunakan Kontrol Server Web Kustom.

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 (!string.IsNullOrEmpty(input.Text))
      {
        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);
    }
  }
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code Provider", "ZipCodeProvider")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
                DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

Bagian ketiga dari kode contoh adalah halaman Web. Di dekat bagian atas adalah Register arahan untuk kontrol pengguna dan kontrol kustom yang digunakan dalam koneksi. Elemen <asp:connectionszone> dideklarasikan di halaman sebagai contoh penggunaan ConnectionsZone kontrol secara deklaratif. Dalam elemen , sejumlah properti diatur secara deklaratif. Properti lain pada zona koneksi diatur secara terprogram di bagian <script> halaman.

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

Muat halaman Web di browser. Gunakan kontrol daftar drop-down Mode Tampilan untuk mengalihkan halaman ke mode sambungkan. Pada menu kata kerja kontrol Penyedia Kode Pos (menu kata kerja ditunjukkan oleh panah ke bawah di bilah judul kontrol), klik kata kerja sambungkan. Kontrol ConnectionsZone muncul. Perhatikan bahwa di antarmuka pengguna koneksi, tombol Akhiri Koneksi muncul; koneksi telah dideklarasikan dalam markup halaman, sehingga kontrol sudah tersambung. Klik Akhiri Koneksi, lalu gunakan kontrol Mode Tampilan lagi untuk mengembalikan halaman untuk menelusuri mode. Selanjutnya, kembalikan halaman ke mode sambungkan lagi, klik kata kerja sambungkan pada salah satu kontrol, dan perhatikan bahwa UI koneksi sekarang menampilkan hyperlink yang memungkinkan Anda membentuk koneksi di antara kontrol. Klik tautan, dan gunakan antarmuka pengguna koneksi untuk memilih titik koneksi dan membuat koneksi.

Keterangan

Dengan menggunakan kumpulan kontrol Bagian Web, Anda dapat mengaktifkan dua kontrol server untuk membentuk koneksi dan berbagi data, dengan satu kontrol yang bertindak sebagai penyedia, dan yang lainnya bertindak sebagai konsumen data. Kedua kontrol dapat berupa WebPart kontrol atau jenis kontrol server lainnya, asalkan dirancang untuk menangani koneksi, dan bahwa mereka berada di WebPartZoneBase zona. Untuk mempelajari selengkapnya tentang koneksi Bagian Web, lihat WebPartConnection gambaran umum kelas dan ConnectionPoint , serta Gambaran Umum Koneksi Bagian Web.

Asalkan kontrol dan kondisi yang diperlukan ada untuk membentuk koneksi Bagian Web, masih perlu untuk benar-benar menyambungkan kontrol. Ada tiga cara untuk membentuk koneksi antar kontrol server: mendeklarasikan koneksi di halaman Web, membuat koneksi dalam kode, atau menambahkan ConnectionsZone kontrol ke halaman sehingga pengguna dapat menyambungkan kontrol sesuai permintaan. Kontrol menghasilkan ConnectionsZone UI yang memungkinkan pengguna untuk menyambungkan atau memutuskan kontrol server apa pun di halaman yang memenuhi kondisi yang diperlukan untuk membentuk koneksi. Ini adalah kontrol opsional yang tidak diperlukan untuk membentuk koneksi, tetapi berguna dalam kasus di mana Anda ingin memberi pengguna kontrol atas kontrol server mana yang terhubung atau terputus.

Kontrol ConnectionsZone adalah salah satu kontrol zona alat Bagian Web yang mewarisi dari ToolZone kelas dasar. Sebagai zona alat, ConnectionsZone kontrol dirancang untuk terlihat hanya ketika halaman Web-nya berada dalam mode tampilan tertentu. Dalam hal ini, mode tampilan diberi nama mode sambungkan (halaman dalam mode ini ketika WebPartManager kontrol pada halaman memiliki nilai properti yang DisplayMode diatur ke ConnectDisplayMode). Setelah pengguna mengalihkan halaman ke mode sambungkan, mereka harus mengklik kata kerja sambungkan pada menu kata kerja salah satu kontrol server, lalu UI koneksi menjadi terlihat.

Sebagai kontrol zona Bagian Web, ConnectionsZone kontrol adalah jenis WebZone zona (yang mewarisi dari CompositeControl kelas) yang dirancang untuk memuat kontrol lain. Secara umum, ConnectionsZone zona memiliki sebagian besar elemen yang sama dengan zona alat Bagian Web lainnya: header, area isi atau konten, dan footer. Untuk diskusi lengkap tentang apa itu zona Bagian Web, dan bagian zona yang berbeda, lihat WebZone gambaran umum kelas.

Penting

Tidak seperti kebanyakan zona Bagian Web lainnya, penting untuk dicatat bahwa ConnectionsZone zona tidak berisi jenis kontrol server unik yang terkait dengannya. Untuk daftar zona dan kontrol terkait yang ada di dalamnya, lihat bagan di WebZone gambaran umum kelas. Tetapi zona tidak ConnectionsZone berisi WebPartConnection kontrol. Sebaliknya, ini melayani tujuan yang sangat terbatas untuk menyediakan UI bagi pengguna untuk menyambungkan atau memutuskan kontrol server yang ada di beberapa WebPartZoneBase zona di halaman. Satu-satunya kontrol yang terkandung dalam ConnectionsZone kontrol adalah kontrol server ASP.NET standar yang dihasilkannya sebagai bagian dari UI-nya untuk membentuk koneksi.

ConnectionsZone Ketika kontrol dirender, kontrol menghasilkan UI berdasarkan kontrol server pada halaman yang mampu membentuk koneksi. Kontrol ConnectionsZone menentukan kontrol server mana di WebPartZoneBase zona di halaman adalah penyedia, yang merupakan konsumen, titik koneksi mana yang tersedia, dan apakah kontrol server saat ini terhubung atau terputus, dan kemudian menghasilkan UI yang sesuai.

Misalnya, misalkan ada satu WebPart kontrol yang mampu menjadi penyedia, satu WebPart kontrol yang mampu menjadi konsumen, mereka dinyatakan dalam WebPartZone halaman, dan mereka saat ini terputus. Saat pengguna mengalihkan halaman ke mode sambungkan dan mengklik kata kerja sambungkan di salah satu kontrol, ConnectionsZone kontrol menghasilkan UI dengan tautan yang, saat diklik, menampilkan formulir di mana pengguna dapat memilih opsi untuk membuat koneksi. (Jika kontrol sebelumnya tersambung, tampilan awal malah menyajikan tombol kepada pengguna untuk memutuskan sambungan kontrol). Di antarmuka pengguna koneksi untuk membuat koneksi baru, pengguna ditampilkan kontrol mana yang merupakan penyedia, dan kontrol mana yang merupakan konsumen. Kontrol daftar drop-down muncul di bawah setiap kontrol server, mencantumkan objek yang tersedia ConnectionPoint untuk kontrol. Dari daftar drop-down masing-masing, pengguna harus memilih satu ProviderConnectionPoint objek untuk penyedia (untuk menentukan antarmuka dan data apa yang akan dibagikan dengan konsumen), dan satu ConsumerConnectionPoint objek untuk setiap konsumen (untuk menentukan antarmuka dan data apa yang akan dikonsumsi konsumen) yang akan terhubung ke penyedia.

Catatan

Dalam kontrol Bagian Web mengatur implementasi default, satu penyedia dapat tersambung ke banyak konsumen, tetapi konsumen hanya dapat memiliki satu penyedia.

Untuk menggunakan kontrol, ConnectionsZone Anda bisa mendeklarasikannya di dalam <form> elemen pada halaman Web (tetapi tidak ditumpuk dalam elemen zona Bagian Web lain), menggunakan elemen , <asp:connectionszone> atau Anda bisa menambahkannya ke halaman secara terprogram. Jika Anda mendeklarasikan elemen dalam halaman, tidak seperti zona Bagian Web lainnya, Anda tidak dapat mendeklarasikan tipe kontrol server lainnya di antara tag <asp:connectionszone> elemen. Anda dapat mendeklarasikan elemen di dalamnya yang berkaitan dengan properti dan detail gayanya sendiri, tetapi ini adalah elemen mandiri dan bukan kontrol templat di mana kontrol server lain dapat dideklarasikan.

Catatan

Untuk meningkatkan aksesibilitas, ConnectionsZone kontrol dirender dalam <fieldset> elemen . Elemen mengelompokkan <fieldset> serangkaian kontrol terkait yang digunakan untuk membuat koneksi dalam ConnectionsZone kontrol, dan memfasilitasi navigasi bertab di antara kontrol tersebut untuk agen pengguna visual (seperti browser Web biasa) dan agen pengguna berorientasi ucapan (seperti perangkat lunak pembacaan layar).

Kontrol ConnectionsZone memiliki sejumlah properti yang digunakannya untuk merender UI koneksi. Satu set properti mencakup beberapa kata kerja--hanya digunakan dalam kaitannya dengan koneksi--yang melakukan tindakan di UI: ConfigureVerb, , ConnectVerbdan DisconnectVerb. Sekumpulan besar properti, digunakan terutama untuk antarmuka pengguna zona koneksi, terdiri dari string teks yang ditampilkan di berbagai tempat (atau dalam situasi tertentu, seperti ketika kesalahan terjadi) di UI: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToConsumerTitleConnectToProviderTitleConsumersInstructionTextConsumersTitleConnectToProviderTextConnectToConsumerTextGetFromTextNewConnectionErrorMessageConnectToProviderInstructionTextExistingConnectionErrorMessageGetTextInstructionTitle, NoExistingConnectionInstructionText, , ProvidersInstructionTextNoExistingConnectionTitle, , ProvidersTitle, , SendTextdan .SendToText Kelas ConnectionsZone juga berisi sejumlah properti umum yang ditemukan di zona Bagian Web lainnya: CancelVerb, , CloseVerb, Display, EmptyZoneTextHeaderText, InstructionText, dan PartChromeType. Akhirnya, WebPartToConnect properti ini unik untuk kelas , mereferensikan kontrol yang memulai koneksi (ini adalah kontrol di mana pengguna mengklik kata kerja sambungkan di menu kata kerjanya, yang juga merupakan kontrol yang dirujuk dalam WebPartManager properti kontrol SelectedWebPart ).

Kelas ini ConnectionsZone juga memiliki sejumlah metode, yang semuanya diwariskan dan ditimpa dari kelas dasar, dan sebagian besar berasal dari kelas zona Bagian Web dasar. Untuk detailnya, lihat metode individual.

Catatan Bagi Inheritor

Kelas ConnectionsZone dapat diperpanjang, jika pengembang ingin mengubah perilakunya atau UI default yang disediakan untuk bekerja dengan koneksi.

Konstruktor

ConnectionsZone()

Menginisialisasi instans baru kelas ConnectionsZone.

Properti

AccessKey

Mendapatkan atau mengatur kunci akses yang memungkinkan Anda menavigasi dengan cepat ke kontrol server Web.

(Diperoleh dari WebControl)
Adapter

Mendapatkan adaptor khusus browser untuk kontrol.

(Diperoleh dari Control)
AppRelativeTemplateSourceDirectory

Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini.

(Diperoleh dari Control)
AssociatedDisplayModes

Mendapatkan kumpulan WebPartDisplayMode objek yang terkait dengan zona tertentu ToolZone .

(Diperoleh dari ToolZone)
Attributes

Mendapatkan kumpulan atribut arbitrer (hanya untuk penyajian) yang tidak sesuai dengan properti pada kontrol.

(Diperoleh dari WebControl)
BackColor

Mendapatkan atau mengatur warna latar belakang kontrol server Web.

(Diperoleh dari WebControl)
BackImageUrl

Mendapatkan atau mengatur URL ke gambar latar belakang untuk zona.

(Diperoleh dari WebZone)
BindingContainer

Mendapatkan kontrol yang berisi pengikatan data kontrol ini.

(Diperoleh dari Control)
BorderColor

Mendapatkan atau menyetel warna batas kontrol Web.

(Diperoleh dari WebControl)
BorderStyle

Mendapatkan atau mengatur gaya batas kontrol server Web.

(Diperoleh dari WebControl)
BorderWidth

Mendapatkan atau mengatur lebar batas kontrol server Web.

(Diperoleh dari WebControl)
CancelVerb

Mendapatkan referensi ke WebPartVerb objek yang memungkinkan pengguna akhir membatalkan proses pembuatan koneksi.

ChildControlsCreated

Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat.

(Diperoleh dari Control)
ClientID

Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET.

(Diperoleh dari Control)
ClientIDMode

Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti.

(Diperoleh dari Control)
ClientIDSeparator

Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti .

(Diperoleh dari Control)
CloseVerb

Mendapatkan referensi ke WebPartVerb objek yang memungkinkan pengguna akhir menutup antarmuka pengguna koneksi (UI) yang dibuat oleh ConnectionsZone kontrol.

ConfigureConnectionTitle

Mendapatkan atau mengatur teks yang ditampilkan sebagai judul subbagian antarmuka pengguna koneksi (UI) yang ConnectionsZone dibuat oleh kontrol.

ConfigureVerb

Mendapatkan referensi ke objek yang WebPartVerb digunakan untuk membuka tampilan konfigurasi di antarmuka pengguna koneksi (UI).

ConnectToConsumerInstructionText

Mendapatkan atau mengatur teks instruksi yang ditampilkan di bagian antarmuka pengguna koneksi (UI) tempat pengguna memilih titik koneksi konsumen yang akan disambungkan oleh penyedia.

ConnectToConsumerText

Mendapatkan atau mengatur teks hyperlink yang diklik pengguna untuk membuka tampilan di mana mereka bisa memilih kontrol konsumen untuk koneksi.

ConnectToConsumerTitle

Mendapatkan atau mengatur teks judul bagian di antarmuka pengguna koneksi (UI) tempat pengguna dapat memilih konsumen tertentu untuk disambungkan.

ConnectToProviderInstructionText

Mendapatkan atau mengatur teks instruksi yang ditampilkan di bagian antarmuka pengguna koneksi (UI) tempat pengguna memilih titik koneksi penyedia yang akan disambungkan konsumen.

ConnectToProviderText

Mendapatkan atau mengatur teks hyperlink yang diklik pengguna untuk membuka tampilan di mana mereka bisa memilih kontrol penyedia untuk koneksi.

ConnectToProviderTitle

Mendapatkan atau mengatur teks judul bagian di antarmuka pengguna koneksi (UI) tempat pengguna dapat memilih penyedia tertentu untuk disambungkan.

ConnectVerb

Mendapatkan referensi ke WebPartVerb objek yang memungkinkan dua WebPart kontrol untuk membuat koneksi.

ConsumersInstructionText

Mendapatkan atau mengatur teks instruksional yang ditampilkan di bagian konsumen dari antarmuka pengguna koneksi (UI), ketika koneksi sudah ada.

ConsumersTitle

Mendapatkan atau mengatur judul yang ditunjukkan di atas bagian konsumen dari antarmuka pengguna koneksi (UI), ketika koneksi sudah ada.

Context

Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini.

(Diperoleh dari Control)
Controls

ControlCollection Mendapatkan objek yang mewakili kontrol anak dalam CompositeControl.

(Diperoleh dari CompositeControl)
ControlStyle

Mendapatkan gaya kontrol server Web. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
ControlStyleCreated

Mendapatkan nilai yang menunjukkan apakah Style objek telah dibuat untuk ControlStyle properti . Properti ini terutama digunakan oleh pengembang kontrol.

(Diperoleh dari WebControl)
CssClass

Mendapatkan atau mengatur kelas Lembar Gaya Bertingkat (CSS) yang dirender oleh kontrol server Web pada klien.

(Diperoleh dari WebControl)
DataItemContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataItemContainermengimplementasikan .

(Diperoleh dari Control)
DataKeysContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataKeysControlmengimplementasikan .

(Diperoleh dari Control)
DesignMode

Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain.

(Diperoleh dari Control)
DisconnectVerb

Mendapatkan referensi ke WebPartVerb objek yang memungkinkan pengguna memutuskan sambungan dua kontrol yang tersambung WebPart .

Display

Mendapatkan nilai yang menunjukkan apakah ToolZone kontrol saat ini ditampilkan.

EditUIStyle

Mendapatkan atribut gaya untuk kontrol yang dapat diedit yang terkandung dalam ToolZone kontrol.

(Diperoleh dari ToolZone)
EmptyZoneText

Mendapatkan atau menyetel pesan teks yang ditampilkan dalam kontrol kosong ConnectionsZone jika tidak ada cukup kontrol pada halaman Web untuk membuat koneksi.

EmptyZoneTextStyle

Mendapatkan atribut gaya untuk teks tempat penampung di zona kosong.

(Diperoleh dari WebZone)
Enabled

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web diaktifkan.

(Diperoleh dari WebControl)
EnableTheming

Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini.

(Diperoleh dari WebControl)
EnableViewState

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan kontrol anak apa pun yang dikandungnya, ke klien yang meminta.

(Diperoleh dari Control)
ErrorStyle

Mendapatkan atribut gaya untuk merender pesan kesalahan yang ditampilkan jika WebPart kontrol tidak dapat dimuat atau dibuat.

(Diperoleh dari WebZone)
Events

Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca.

(Diperoleh dari Control)
ExistingConnectionErrorMessage

Mendapatkan atau mengatur teks pesan yang ditampilkan di antarmuka pengguna koneksi (UI) ketika ada kesalahan atau peringatan pada koneksi yang ada.

Font

Mendapatkan properti font yang terkait dengan kontrol server Web.

(Diperoleh dari WebControl)
FooterStyle

Mendapatkan atribut gaya untuk konten area footer zona.

(Diperoleh dari WebZone)
ForeColor

Mendapatkan atau mengatur warna latar depan (biasanya warna teks) kontrol server Web.

(Diperoleh dari WebControl)
GetFromText

Mendapatkan atau mengatur teks yang ditampilkan di bagian antarmuka pengguna koneksi (UI) yang mendahului penyedia bernama tempat konsumen akan mengambil data.

GetText

Mendapatkan atau mengatur teks yang ditampilkan di bagian antarmuka pengguna koneksi (UI) yang mendahului konsumen bernama yang akan menerima data dari penyedia.

HasAttributes

Mendapatkan nilai yang menunjukkan apakah kontrol memiliki atribut yang ditetapkan.

(Diperoleh dari WebControl)
HasChildViewState

Mendapatkan nilai yang menunjukkan apakah kontrol turunan kontrol server saat ini memiliki pengaturan status tampilan yang disimpan.

(Diperoleh dari Control)
HasFooter

Mendapatkan nilai yang menunjukkan apakah zona memiliki area footer.

(Diperoleh dari WebZone)
HasHeader

Mendapatkan nilai yang menunjukkan apakah zona memiliki area header.

(Diperoleh dari WebZone)
HeaderCloseVerb

Mendapatkan referensi ke WebPartVerb objek di header ToolZone kontrol yang digunakan untuk menutup kontrol.

(Diperoleh dari ToolZone)
HeaderStyle

Mendapatkan atribut gaya untuk konten area header zona.

(Diperoleh dari WebZone)
HeaderText

Mendapatkan atau mengatur teks header yang muncul di bagian atas antarmuka pengguna koneksi (UI) yang dibuat oleh ConnectionsZone kontrol.

HeaderVerbStyle

Mendapatkan atribut gaya untuk semua kata kerja header yang ditampilkan dalam ToolZone kontrol.

(Diperoleh dari ToolZone)
Height

Mendapatkan atau mengatur tinggi kontrol server Web.

(Diperoleh dari WebControl)
ID

Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server.

(Diperoleh dari Control)
IdSeparator

Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol.

(Diperoleh dari Control)
InstructionText

Mendapatkan atau mengatur teks yang digunakan untuk instruksi umum tentang kontrol yang dipilih di bagian antarmuka pengguna koneksi (UI) untuk mengelola koneksi yang ada.

InstructionTextStyle

Mendapatkan atribut gaya untuk teks instruksi yang muncul di bagian ToolZone atas kontrol.

(Diperoleh dari ToolZone)
InstructionTitle

Mendapatkan atau mengatur teks yang digunakan untuk deskripsi umum tindakan yang dapat dilakukan pada kontrol konsumen atau penyedia, dalam antarmuka pengguna koneksi (UI) untuk mengelola koneksi yang ada.

IsChildControlStateCleared

Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol.

(Diperoleh dari Control)
IsEnabled

Mendapatkan nilai yang menunjukkan apakah kontrol diaktifkan.

(Diperoleh dari WebControl)
IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya.

(Diperoleh dari Control)
IsViewStateEnabled

Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini.

(Diperoleh dari Control)
LabelStyle

Mendapatkan atribut gaya untuk konten label yang muncul bersama kontrol pengeditan dalam ToolZone kontrol. Kontrol turunan ToolZone , seperti CatalogZone dan EditorZone, terapkan gaya ke label.

(Diperoleh dari ToolZone)
LoadViewStateByID

Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks.

(Diperoleh dari Control)
NamingContainer

Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID .

(Diperoleh dari Control)
NewConnectionErrorMessage

Mendapatkan atau mengatur teks pesan yang ditampilkan di antarmuka pengguna koneksi (UI) ketika ada kesalahan atau peringatan pada koneksi baru yang coba dibuat pengguna.

NoExistingConnectionInstructionText

Mendapatkan atau mengatur teks instruksi yang muncul di isi antarmuka pengguna koneksi (UI) ketika kontrol Bagian Web tidak memiliki koneksi yang ada.

NoExistingConnectionTitle

Mendapatkan atau menyetel teks judul yang muncul di isi antarmuka pengguna koneksi (UI) ketika kontrol Bagian Web tidak memiliki koneksi yang ada.

Padding

Mendapatkan atau mengatur atribut padding sel pada tabel yang berisi WebPart kontrol di zona.

(Diperoleh dari WebZone)
Page

Mendapatkan referensi ke Page instans yang berisi kontrol server.

(Diperoleh dari Control)
Parent

Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman.

(Diperoleh dari Control)
PartChromePadding

Mendapatkan atau mengatur jarak antara konten WebPart kontrol dan batas kontrol.

(Diperoleh dari WebZone)
PartChromeStyle

Mendapatkan karakteristik gaya yang berlaku untuk batas kontrol Bagian Web yang dimuat oleh zona.

(Diperoleh dari WebZone)
PartChromeType

Mendapatkan atau mengatur jenis batas yang membingkai kontrol server yang terkandung dalam ConnectionsZone kontrol.

PartStyle

Mendapatkan karakteristik gaya yang berlaku untuk batas dan isi setiap kontrol Komponen Web yang dimuat oleh zona.

(Diperoleh dari WebZone)
PartTitleStyle

Mendapatkan atribut gaya untuk konten bilah judul untuk setiap kontrol Komponen Web yang dimuat oleh zona.

(Diperoleh dari WebZone)
ProvidersInstructionText

Mendapatkan atau mengatur teks instruksional yang ditampilkan di bagian penyedia antarmuka pengguna koneksi (UI), ketika koneksi sudah ada.

ProvidersTitle

Mendapatkan atau mengatur judul yang ditunjukkan di atas bagian penyedia antarmuka pengguna koneksi (UI), ketika koneksi sudah ada.

RenderClientScript

Mendapatkan nilai yang menunjukkan apakah akan merender skrip klien di halaman Bagian Web.

(Diperoleh dari WebZone)
RenderingCompatibility

Mendapatkan nilai yang menentukan versi ASP.NET yang dirender HTML akan kompatibel.

(Diperoleh dari Control)
SendText

Mendapatkan atau mengatur teks yang ditampilkan di bagian antarmuka pengguna koneksi (UI) yang mendahului penyedia bernama yang akan mengirim data ke konsumen.

SendToText

Mendapatkan atau mengatur teks yang ditampilkan di bagian antarmuka pengguna koneksi (UI) yang mendahului konsumen bernama tempat penyedia akan mengirim data.

Site

Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain.

(Diperoleh dari Control)
SkinID

Mendapatkan atau mengatur kulit untuk diterapkan ke kontrol.

(Diperoleh dari WebControl)
Style

Mendapatkan kumpulan atribut teks yang akan dirender sebagai atribut gaya pada tag luar kontrol server Web.

(Diperoleh dari WebControl)
SupportsDisabledAttribute

Mendapatkan nilai yang menunjukkan apakah kontrol harus mengatur disabled atribut elemen HTML yang dirender ke "dinonaktifkan" ketika properti kontrol IsEnabled adalah false.

(Diperoleh dari CompositeControl)
TabIndex

Mendapatkan atau mengatur indeks tab kontrol server Web.

(Diperoleh dari WebControl)
TagKey

HtmlTextWriterTag Mendapatkan nilai yang sesuai dengan kontrol server Web ini. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebZone)
TagName

Mendapatkan nama tag kontrol. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
TemplateControl

Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini.

(Diperoleh dari Control)
TemplateSourceDirectory

Mendapatkan direktori Page virtual dari atau UserControl yang berisi kontrol server saat ini.

(Diperoleh dari Control)
ToolTip

Mendapatkan atau mengatur teks yang ditampilkan saat penunjuk mouse mengarah ke kontrol server Web.

(Diperoleh dari WebControl)
UniqueID

Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server.

(Diperoleh dari Control)
ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya.

(Diperoleh dari Control)
VerbButtonType

Mendapatkan atau mengatur jenis tombol apa yang digunakan untuk mewakili kata kerja di zona.

(Diperoleh dari WebZone)
VerbStyle

Mendapatkan atribut gaya untuk kata kerja antarmuka pengguna (UI) yang terkait dengan kontrol Komponen Web di zona.

(Diperoleh dari WebZone)
ViewState

Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama.

(Diperoleh dari Control)
ViewStateIgnoresCase

Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil.

(Diperoleh dari Control)
ViewStateMode

Mendapatkan atau mengatur mode view-state kontrol ini.

(Diperoleh dari Control)
Visible

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server dirender sebagai elemen antarmuka pengguna (UI) di halaman.

(Diperoleh dari ToolZone)
WebPartManager

Mendapatkan referensi ke kontrol yang WebPartManagerWebZone terkait dengan instans kontrol pada halaman Bagian Web.

(Diperoleh dari WebZone)
WebPartToConnect

Mendapatkan kontrol yang saat ini dipilih WebPart untuk disambungkan.

Width

Mendapatkan atau menyetel lebar kontrol server Web.

(Diperoleh dari WebControl)

Metode

AddAttributesToRender(HtmlTextWriter)

Menambahkan atribut dan gaya HTML yang perlu dirender ke yang ditentukan HtmlTextWriterTag. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
AddedControl(Control, Int32)

Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek.

(Diperoleh dari Control)
AddParsedSubObject(Object)

Memberi tahu kontrol server bahwa elemen, BAIK XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server.

(Diperoleh dari Control)
ApplyStyle(Style)

Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, menimpa elemen gaya kontrol yang ada. Metode ini terutama digunakan oleh pengembang kontrol.

(Diperoleh dari WebControl)
ApplyStyleSheetSkin(Page)

Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol.

(Diperoleh dari Control)
BeginRenderTracing(TextWriter, Object)

Memulai pelacakan waktu desain dari data penyajian.

(Diperoleh dari Control)
BuildProfileTree(String, Boolean)

Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman.

(Diperoleh dari Control)
ClearCachedClientID()

Mengatur nilai yang di-cache ClientID ke null.

(Diperoleh dari Control)
ClearChildControlState()

Menghapus informasi status kontrol untuk kontrol turunan kontrol server.

(Diperoleh dari Control)
ClearChildState()

Menghapus informasi status tampilan dan status kontrol untuk semua kontrol turunan kontrol server.

(Diperoleh dari Control)
ClearChildViewState()

Menghapus informasi status tampilan untuk semua kontrol turunan kontrol server.

(Diperoleh dari Control)
ClearEffectiveClientIDMode()

Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit.

(Diperoleh dari Control)
Close()

Menutup antarmuka pengguna koneksi (UI) yang ConnectionsZone dibuat oleh kontrol.

CopyBaseAttributes(WebControl)

Menyalin properti yang tidak dienkapsulasi oleh Style objek dari kontrol server Web yang ditentukan ke kontrol server Web tempat metode ini dipanggil. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
CreateChildControls()

Membuat semua kontrol anak yang ConnectionsZone terkandung dalam kontrol sebagai persiapan untuk memposting kembali ke server atau penyajian.

CreateControlCollection()

Membuat objek baru ControlCollection untuk menahan kontrol anak (baik harfiah maupun server) kontrol server.

(Diperoleh dari Control)
CreateControlStyle()

Membuat objek gaya yang digunakan secara internal oleh WebControl kelas untuk mengimplementasikan semua properti terkait gaya. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
DataBind()

Mengikat sumber data ke CompositeControl dan semua kontrol anaknya.

(Diperoleh dari CompositeControl)
DataBind(Boolean)

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.

(Diperoleh dari Control)
DataBindChildren()

Mengikat sumber data ke kontrol anak kontrol server.

(Diperoleh dari Control)
Dispose()

Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dirilis dari memori.

(Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)

Mengakhiri pelacakan waktu desain data penyajian.

(Diperoleh dari Control)
EnsureChildControls()

Menentukan apakah kontrol server berisi kontrol anak. Jika tidak, itu membuat kontrol anak.

(Diperoleh dari Control)
EnsureID()

Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan.

(Diperoleh dari Control)
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindControl(String)

Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan id .

(Diperoleh dari Control)
FindControl(String, Int32)

Mencari kontainer penamaan saat ini untuk kontrol server dengan yang ditentukan id dan bilangan bulat, yang ditentukan dalam pathOffset parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini.

(Diperoleh dari Control)
Focus()

Mengatur fokus input ke kontrol.

(Diperoleh dari Control)
GetDesignModeState()

Mendapatkan data waktu desain untuk kontrol.

(Diperoleh dari Control)
GetEffectiveChromeType(Part)

Mengembalikan nilai WebPart kontrol aktual atau efektif saat iniPartChromeType, mengingat PartChromeType properti zona dan mode tampilan halaman Bagian Web saat ini.

(Diperoleh dari WebZone)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetRouteUrl(Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(String, Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetRouteUrl(String, RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)

Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan.

(Diperoleh dari Control)
HasControls()

Menentukan apakah kontrol server berisi kontrol anak apa pun.

(Diperoleh dari Control)
HasEvents()

Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun.

(Diperoleh dari Control)
IsLiteralContent()

Menentukan apakah kontrol server hanya menyimpan konten harfiah.

(Diperoleh dari Control)
LoadControlState(Object)

Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode .

LoadViewState(Object)

Memulihkan informasi status tampilan dari permintaan halaman sebelumnya yang disimpan oleh SaveViewState() metode .

MapPathSecure(String)

Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan.

(Diperoleh dari Control)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
MergeStyle(Style)

Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, tetapi tidak akan menimpa elemen gaya kontrol yang ada. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
OnBubbleEvent(Object, EventArgs)

Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman.

(Diperoleh dari Control)
OnDataBinding(EventArgs)

Memunculkan kejadian DataBinding.

(Diperoleh dari Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Memunculkan kejadian DisplayModeChanged.

OnInit(EventArgs)

Memunculkan kejadian Init.

OnLoad(EventArgs)

Memunculkan kejadian Load.

(Diperoleh dari Control)
OnPreRender(EventArgs)

Memunculkan kejadian PreRender.

(Diperoleh dari WebZone)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Memunculkan kejadian SelectedWebPartChanged.

OnUnload(EventArgs)

Memunculkan kejadian Unload.

(Diperoleh dari Control)
OpenFile(String)

Stream Menggunakan untuk membaca file.

(Diperoleh dari Control)
RaiseBubbleEvent(Object, EventArgs)

Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.

(Diperoleh dari Control)
RaisePostBackEvent(String)

Memunculkan peristiwa untuk ConnectionsZone kontrol ketika formulir yang berisinya memposting kembali ke server.

RecreateChildControls()

Membuat ulang kontrol anak dalam kontrol yang berasal dari CompositeControl.

(Diperoleh dari CompositeControl)
RemovedControl(Control)

Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek.

(Diperoleh dari Control)
Render(HtmlTextWriter)

Merender konten ConnectionsZone kontrol ke objek yang ditentukan HtmlTextWriter .

RenderBeginTag(HtmlTextWriter)

Merender tag HTML pembuka kontrol zona ke objek yang ditentukan HtmlTextWriter .

(Diperoleh dari WebZone)
RenderBody(HtmlTextWriter)

Mengirim isi area isi ConnectionsZone kontrol ke objek yang ditentukan HtmlTextWriter , yang menulis isi ke halaman Web.

RenderChildren(HtmlTextWriter)

Mengeluarkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.

(Diperoleh dari Control)
RenderContents(HtmlTextWriter)

Merender seluruh konten kontrol zona antara tag awal dan akhir ke objek yang ditentukan HtmlTextWriter .

(Diperoleh dari WebZone)
RenderControl(HtmlTextWriter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.

(Diperoleh dari Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .

(Diperoleh dari Control)
RenderEndTag(HtmlTextWriter)

Merender tag penutup HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
RenderFooter(HtmlTextWriter)

Mengambil alih metode dasar untuk merender kata kerja di footer ToolZone kontrol.

(Diperoleh dari ToolZone)
RenderHeader(HtmlTextWriter)

Mengambil alih metode dasar untuk menyediakan penyajian khusus untuk area header yang diperlukan oleh ToolZone kontrol.

(Diperoleh dari ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Merender kata kerja individu dengan ToolZone kontrol.

(Diperoleh dari ToolZone)
RenderVerbs(HtmlTextWriter)

Merender kata kerja tingkat zona untuk ConnectionsZone kontrol.

ResolveAdapter()

Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan.

(Diperoleh dari Control)
ResolveClientUrl(String)

Mendapatkan URL yang dapat digunakan oleh browser.

(Diperoleh dari Control)
ResolveUrl(String)

Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta.

(Diperoleh dari Control)
SaveControlState()

Menyimpan perubahan status kontrol Bagian Web yang terjadi sejak terakhir kali halaman diposting kembali ke server.

SaveViewState()

ConnectionsZone Menyimpan perubahan status tampilan kontrol yang terjadi sejak halaman terakhir kali diposting kembali ke server.

SetDesignModeState(IDictionary)

Mengatur data waktu desain untuk kontrol.

(Diperoleh dari Control)
SetRenderMethodDelegate(RenderMethod)

Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya.

(Diperoleh dari Control)
SetTraceData(Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan.

(Diperoleh dari Control)
SetTraceData(Object, Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan.

(Diperoleh dari Control)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
TrackViewState()

Melacak perubahan status tampilan pada ConnectionsZone kontrol sehingga perubahan dapat disimpan di objek kontrol StateBag .

Acara

DataBinding

Terjadi ketika kontrol server mengikat ke sumber data.

(Diperoleh dari Control)
Disposed

Terjadi ketika kontrol server dirilis dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta.

(Diperoleh dari Control)
Init

Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya.

(Diperoleh dari Control)
Load

Terjadi ketika kontrol server dimuat ke Page dalam objek.

(Diperoleh dari Control)
PreRender

Terjadi setelah Control objek dimuat tetapi sebelum penyajian.

(Diperoleh dari Control)
Unload

Terjadi ketika kontrol server dibongkar dari memori.

(Diperoleh dari Control)

Implementasi Antarmuka Eksplisit

IAttributeAccessor.GetAttribute(String)

Mendapatkan atribut kontrol Web dengan nama yang ditentukan.

(Diperoleh dari WebControl)
IAttributeAccessor.SetAttribute(String, String)

Menyetel atribut kontrol Web ke nama dan nilai yang ditentukan.

(Diperoleh dari WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Memungkinkan perancang untuk membuat ulang kumpulan kontrol komposit kontrol anak di lingkungan waktu desain.

(Diperoleh dari CompositeControl)
IControlBuilderAccessor.ControlBuilder

Untuk deskripsi anggota ini, lihat ControlBuilder.

(Diperoleh dari Control)
IControlDesignerAccessor.GetDesignModeState()

Untuk deskripsi anggota ini, lihat GetDesignModeState().

(Diperoleh dari Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary).

(Diperoleh dari Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Untuk deskripsi anggota ini, lihat SetOwnerControl(Control).

(Diperoleh dari Control)
IControlDesignerAccessor.UserData

Untuk deskripsi anggota ini, lihat UserData.

(Diperoleh dari Control)
IDataBindingsAccessor.DataBindings

Untuk deskripsi anggota ini, lihat DataBindings.

(Diperoleh dari Control)
IDataBindingsAccessor.HasDataBindings

Untuk deskripsi anggota ini, lihat HasDataBindings.

(Diperoleh dari Control)
IExpressionsAccessor.Expressions

Untuk deskripsi anggota ini, lihat Expressions.

(Diperoleh dari Control)
IExpressionsAccessor.HasExpressions

Untuk deskripsi anggota ini, lihat HasExpressions.

(Diperoleh dari Control)
IParserAccessor.AddParsedSubObject(Object)

Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object).

(Diperoleh dari Control)
IPostBackEventHandler.RaisePostBackEvent(String)

RaisePostBackEvent(String) Menerapkan metode .

(Diperoleh dari ToolZone)

Metode Ekstensi

FindDataSourceControl(Control)

Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan.

FindFieldTemplate(Control, String)

Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan.

FindMetaTable(Control)

Mengembalikan objek metatable untuk kontrol data yang berisi.

GetDefaultValues(INamingContainer)

Mendapatkan kumpulan nilai default untuk kontrol data yang ditentukan.

GetMetaTable(INamingContainer)

Mendapatkan metadata tabel untuk kontrol data yang ditentukan.

SetMetaTable(INamingContainer, MetaTable)

Mengatur metadata tabel untuk kontrol data yang ditentukan.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.

SetMetaTable(INamingContainer, MetaTable, Object)

Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.

TryGetMetaTable(INamingContainer, MetaTable)

Menentukan apakah metadata tabel tersedia.

EnableDynamicData(INamingContainer, Type)

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

EnableDynamicData(INamingContainer, Type, Object)

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

Berlaku untuk

Lihat juga