ConnectionsZone Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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::ToolZonepublic class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZonetype ConnectionsZone = class
inherit ToolZonePublic 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 mengatur 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 Cascading Style Sheet (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 mengatur pesan teks yang ditampilkan dalam kontrol kosong ConnectionsZone jika kontrol tidak mencukupi 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 tentang 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 mengatur 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 pada 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 |
| 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 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 mengatur 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 |
| 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 terkandung dalam ConnectionsZone 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 |
| FindControl(String, Int32) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan yang ditentukan |
| 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
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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk