ConnectionsZone Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Kullanıcıların ve bölgelerde bulunan WebPartZoneBase diğer sunucu denetimleri arasında WebPart bağlantı oluşturmalarını sağlayan bir kullanıcı arabirimi (UI) sağlar.
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- Devralma
Örnekler
Aşağıdaki kod örneği, Web Bölümleri sayfasında denetimin ConnectionsZone nasıl kullanılacağını gösterir. Örnekte dört bölüm vardır:
Web sayfasında görüntüleme modlarını değiştirmenizi sağlayan bir kullanıcı denetimi.
Posta Kodu arabiriminin kodunu içeren bir kaynak dosya ve bağlantı için sağlayıcı ve tüketici olarak davranan iki WebPart denetim.
Tüm denetimleri barındıran, bir
<asp:connectionszone>öğenin nasıl bildirildiğini gösteren ve bağlantı bölgesi üzerinde bildirimli ve programlı olarak bir dizi özellik ayarlayan bir Web sayfası.Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.
Bu kod örneğinin ilk bölümü, kullanıcıların Bir Web sayfasında görüntüleme modlarını değiştirmesini sağlayan kullanıcı denetimidir. Bu denetimdeki görüntü modları ve kaynak kodun açıklaması hakkında ayrıntılı bilgi için bkz . İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.
<%@ 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>
Örneğin ikinci bölümü, arabirimi ve özel denetimleri olan kaynak dosyasıdır. Denetimin ZipCodeWebPart arabirimini uyguladığına ve denetimin IZipCode bir ConnectionProvider bağlantı için sağlayıcı olarak hareket edebilmesi için bir öznitelik ekleyerek dikkat edin. DenetiminWeatherWebPart, arabirimini tükettiği IZipCode bir öznitelikle işaretlenmiş bir ConnectionConsumer yöntemi vardır, böylece bir bağlantıda tüketici olarak hareket edebilir.
Kod örneğinin çalışması için bu kaynak kodunu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin App_Code klasörüne koyabilirsiniz; burada çalışma zamanında dinamik olarak derlenir. Bu örnekte dinamik derleme kullanılır. Derlemeyi gösteren bir izlenecek yol için bkz . İzlenecek Yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.
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
Örnek kodun üçüncü bölümü Web sayfasıdır. Üst kısımda kullanıcı denetimine ve bağlantıda kullanılan özel denetimlere yönelik yönergeler bulunur Register . Öğe <asp:connectionszone> , denetimi bildirimli olarak kullanmanın ConnectionsZone bir örneği olarak sayfada bildirilir. öğesinde, bir dizi özellik bildirimli olarak ayarlanır. Bağlantılar bölgesindeki diğer özellikler, sayfanın bölümünde program aracılığıyla <script> ayarlanır.
<%@ 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>
Web sayfasını bir tarayıcıya yükleyin. Sayfayı bağlantı moduna geçmek için Görüntü Modu açılan liste denetimini kullanın. Posta Kodu Sağlayıcısı denetiminin fiiller menüsünde (fiiller menüsü, denetimin başlık çubuğundaki aşağı okla gösterilir), bağlanma fiiline tıklayın. Bir ConnectionsZone denetim görüntülenir. Bağlantı kullanıcı arabiriminde bir Bağlantıyı Sonlandır düğmesinin göründüğüne dikkat edin; bağlantı, sayfanın işaretlemesinde zaten bildirilmiştir, bu nedenle denetimler zaten bağlantılıdır. Bağlantıyı Sonlandır'a tıklayın ve sayfayı göz atma moduna döndürmek için Görüntü Modu denetimini yeniden kullanın. Ardından, bağlantı moduna geçmek için sayfayı yeniden döndürüp denetimlerden birinde bağlantı fiiline tıklayın ve bağlantı kullanıcı arabiriminde artık denetimler arasında bağlantı oluşturmanıza olanak tanıyan bir köprü görüntülendiğini unutmayın. Bağlantıya tıklayın ve bağlantı noktalarını seçmek ve bağlantıyı kurmak için bağlantı kullanıcı arabirimini kullanın.
Açıklamalar
Web Bölümleri denetim kümesini kullanarak, iki sunucu denetiminin bir bağlantı oluşturmasını ve verileri paylaşmasını sağlayabilirsiniz. Bu denetimlerden biri sağlayıcı, diğeri ise verilerin tüketicisi olarak hareket eder. İki denetim, bağlantıları işlemek için tasarlanmış olmaları ve bir bölgede ikamet etmeleri koşuluyla denetimler veya başka bir WebPartZoneBase tür sunucu denetimi olabilirWebPart. Web Bölümleri bağlantıları hakkında daha fazla bilgi edinmek için ve ConnectionPoint sınıfına WebPartConnection genel bakışlara ve Web Bölümleri Bağlantılarına Genel Bakış'a bakın.
Web Bölümleri bağlantısı oluşturmak için gerekli denetimlerin ve koşulların mevcut olması koşuluyla, denetimlerin gerçekten bağlanması yine de gereklidir. Sunucu denetimleri arasında bağlantı oluşturmanın üç yolu vardır: Web sayfasında bağlantı bildirme, kodda bağlantı oluşturma veya kullanıcıların isteğe bağlı olarak denetimleri bağlayabilmesi için sayfaya denetim ekleme ConnectionsZone . Denetim, ConnectionsZone kullanıcıların bir sayfadaki bağlantı oluşturmak için gereken koşulları karşılayan sunucu denetimlerine bağlanmasını veya bağlantısını kesmesini sağlayan bir kullanıcı arabirimi oluşturur. Bu, bağlantıları oluşturmak için gerekli olmayan isteğe bağlı bir denetimdir, ancak kullanıcılara hangi sunucu denetimlerinin bağlı veya bağlantısı kesildiği üzerinde denetim vermek istediğinizde kullanışlıdır.
Denetim ConnectionsZone , temel sınıftan devralan Web Bölümleri araç bölgesi denetimlerinden ToolZone biridir. Bir araç bölgesi olarak, ConnectionsZone denetim yalnızca Web sayfası belirli bir görüntüleme modunda olduğunda görünür olacak şekilde tasarlanmıştır. Bu durumda, görüntüleme modu bağlantı modu olarak adlandırılır (sayfadaki denetimin WebPartManager özellik değeri olarak ayarlandığında ConnectDisplayModesayfa DisplayMode bu moddadır). Kullanıcılar bir sayfayı bağlantı moduna geçirdikten sonra, sunucu denetimlerinden birinin fiiller menüsünde bir bağlantı fiiline tıklamaları gerekir ve ardından bağlantı kullanıcı arabirimi görünür hale gelir.
Web Bölümleri bölge denetimi olarak denetim, ConnectionsZone diğer denetimleri içerecek şekilde tasarlanmış bir bölge türüdür WebZone (sınıftan CompositeControl devralınır). Genel olarak, bir ConnectionsZone bölge diğer Web Bölümleri araç bölgeleriyle aynı öğelerin çoğuna sahiptir: üst bilgi, gövde veya içerik alanı ve alt bilgi. Web Bölümleri bölgesinin ne olduğu ve bölgenin farklı bölümleri hakkında ayrıntılı bilgi için sınıfa genel bakış konusuna WebZone bakın.
Önemli
Diğer Web Bölümleri bölgelerinin çoğundan farklı olarak, bir ConnectionsZone bölgenin kendisiyle ilişkilendirilmiş benzersiz bir sunucu denetimi türü içermediğini unutmayın. Bölgelerin ve içerdikleri ilişkili denetimlerin listesi için, sınıfa genel bakıştaki WebZone grafiğe bakın. Ancak bölge ConnectionsZone denetimler içermez WebPartConnection . Bunun yerine, kullanıcıların sayfadaki bir WebPartZoneBase bölgede bulunan sunucu denetimlerine bağlanması veya bağlantısını kesmesi için kullanıcı arabirimi sağlamanın çok sınırlı bir amacı vardır. Denetimde ConnectionsZone yer alan tek denetimler, bağlantıları oluşturmak için kullanıcı arabiriminin bir parçası olarak oluşturduğu standart ASP.NET sunucu denetimleridir.
ConnectionsZone Denetim işlendiğinde, sayfadaki bağlantı oluşturabilen sunucu denetimlerini temel alan bir kullanıcı arabirimi oluşturur. Denetim ConnectionsZone , sayfadaki bölgedeki WebPartZoneBase hangi sunucu denetimlerinin sağlayıcılar olduğunu, hangilerinin tüketici olduğunu, hangi bağlantı noktalarının kullanılabilir olduğunu ve sunucu denetimlerinin şu anda bağlı mı yoksa bağlantısız mı olduğunu belirler ve ardından kullanıcı arabirimini buna göre oluşturur.
Örneğin, sağlayıcı olma özelliğine sahip tek WebPart bir denetim olduğunu, tüketici olma yeteneğine sahip bir WebPart denetimin olduğunu, bunların sayfada bir WebPartZone içinde bildirildiğini ve şu anda bağlantılarının kesildiğini varsayalım. Kullanıcı sayfayı bağlantı moduna geçirir ve denetimlerden birinde bağlantı fiiline tıkladığında, ConnectionsZone denetim tıklandığında kullanıcıların bağlantı oluşturma seçeneklerini belirleyebileceği bir form görüntüleyen bir bağlantı içeren bir kullanıcı arabirimi oluşturur. (Denetimler daha önce bağlıysa, ilk görünüm bunun yerine kullanıcılara denetimlerin bağlantısını kesmek için bir düğme gösterir). Yeni bağlantılar oluşturmak için bağlantı kullanıcı arabiriminde, kullanıcılara hangi denetimin sağlayıcı ve hangi denetimin tüketici olduğu gösterilir. Her sunucu denetiminin altında, denetimin kullanılabilir ConnectionPoint nesnelerini listeleyen bir açılan liste denetimi görüntülenir. İlgili açılan listelerden kullanıcıların sağlayıcı için bir ProviderConnectionPoint nesne (tüketicilerle hangi arabirimin ve verilerin paylaşılacağını belirlemek için) ve sağlayıcıya bağlanacak her tüketici için bir ConsumerConnectionPoint nesne (tüketicinin hangi arabirimi ve verileri tüketeceğini belirlemek için) seçmesi gerekir.
Not
Web Bölümleri denetim kümesi varsayılan uygulamasında, bir sağlayıcı birçok tüketiciye bağlanabilir, ancak bir tüketici yalnızca bir sağlayıcıya sahip olabilir.
Denetimi kullanmak ConnectionsZone için, öğesini kullanarak <asp:connectionszone> bir Web sayfasındaki öğesi içinde <form> bildirebilir (ancak başka bir Web Bölümleri bölge öğesi içinde iç içe yerleştiremezsiniz) veya sayfaya program aracılığıyla ekleyebilirsiniz. Bir sayfada öğesini bildirirseniz, diğer Web Bölümleri bölgelerinden farklı olarak, öğesinin etiketleri <asp:connectionszone> arasında başka bir tür sunucu denetimi bildiremezsiniz. İçinde kendi özellikleri ve stil ayrıntılarıyla ilişkili öğeleri bildirebilirsiniz, ancak bu tek başına bir öğedir ve diğer sunucu denetimlerinin bildirilebileceği bir şablon denetimi değildir.
Not
Erişilebilirliği geliştirmek için denetim ConnectionsZone bir <fieldset> öğe içinde işlenir. <fieldset> öğesi, denetimde ConnectionsZone bağlantı kurmak için kullanılan ilgili denetim kümesini gruplandırır ve hem görsel kullanıcı aracıları (normal Web tarayıcıları gibi) hem de konuşma odaklı kullanıcı aracıları (ekran okuma yazılımı gibi) için bu denetimler arasında sekmeli gezintiyi kolaylaştırır.
Denetim, ConnectionsZone bağlantı kullanıcı arabirimini işlemek için kullandığı bir dizi özelliğe sahiptir. Bir özellik kümesi, yalnızca bağlantılarla ilgili olarak kullanılan ve kullanıcı arabiriminde eylemler gerçekleştiren çeşitli fiiller içerir: ConfigureVerb, ConnectVerbve DisconnectVerb. Özellikle bağlantılar bölgesi kullanıcı arabirimi için kullanılan büyük bir özellik kümesi, kullanıcı arabirimindeki çeşitli yerlerde (veya hatalar oluştuğunda gibi bazı durumlarda) görüntülenen metin dizelerinden oluşur: ConfigureConnectionTitle, , , ConnectToConsumerText, , ConnectToConsumerTitle, NoExistingConnectionInstructionTextConnectToProviderInstructionTextConnectToProviderTitleGetFromTextConsumersTitleExistingConnectionErrorMessageConsumersInstructionTextGetTextNoExistingConnectionTitleInstructionTitleConnectToProviderTextNewConnectionErrorMessage, ProvidersInstructionText, ProvidersTitle, SendText, ve .SendToTextConnectToConsumerInstructionText ConnectionsZone sınıfı, diğer Web Bölümleri bölgelerinde bulunan bir dizi ortak özelliği de içerir: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, InstructionText, ve PartChromeType. Son olarak, WebPartToConnect özelliği sınıfına özgüdür ve bağlantıyı başlatan denetime başvurur (bu, kullanıcının fiil menüsünde bağlantı fiiline tıkladığı denetimdir ve bu da denetimin SelectedWebPart özelliğinde WebPartManager başvurulan denetimdir).
sınıfı ConnectionsZone , tümü temel sınıflardan devralınan ve geçersiz kılınan ve çoğu temel Web Bölümleri bölge sınıflarından gelen bir dizi yönteme de sahiptir. Ayrıntılar için tek tek yöntemlere bakın.
Devralanlara Notlar
ConnectionsZone Geliştiriciler davranışını veya bağlantılarla çalışmak için sağladığı varsayılan kullanıcı arabirimini değiştirmek isterse sınıf genişletilebilir.
Oluşturucular
| ConnectionsZone() |
ConnectionsZone sınıfının yeni bir örneğini başlatır. |
Özellikler
| AccessKey |
Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar. (Devralındığı yer: WebControl) |
| Adapter |
Denetim için tarayıcıya özgü bağdaştırıcıyı alır. (Devralındığı yer: Control) |
| AppRelativeTemplateSourceDirectory |
Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar. (Devralındığı yer: Control) |
| AssociatedDisplayModes |
Belirli ToolZone bir bölgeyle ilişkili nesne koleksiyonunu WebPartDisplayMode alır. (Devralındığı yer: ToolZone) |
| Attributes |
Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır. (Devralındığı yer: WebControl) |
| BackColor |
Web sunucusu denetiminin arka plan rengini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BackImageUrl |
Bölge için arka plan görüntüsü URL'sini alır veya ayarlar. (Devralındığı yer: WebZone) |
| BindingContainer |
Bu denetimin veri bağlamasını içeren denetimi alır. (Devralındığı yer: Control) |
| BorderColor |
Web denetiminin kenarlık rengini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BorderStyle |
Web sunucusu denetiminin kenarlık stilini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BorderWidth |
Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
| CancelVerb |
Son kullanıcıların bağlantı kurma işlemini iptal etmelerini sağlayan bir WebPartVerb nesneye başvuru alır. |
| ChildControlsCreated |
Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ClientID |
ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır. (Devralındığı yer: Control) |
| ClientIDMode |
özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar. (Devralındığı yer: Control) |
| ClientIDSeparator |
özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır. (Devralındığı yer: Control) |
| CloseVerb |
Son kullanıcıların denetim tarafından oluşturulan bağlantı kullanıcı arabirimini (UI) kapatmasına olanak tanıyan bir WebPartVerb nesneye ConnectionsZone başvuru alır. |
| ConfigureConnectionTitle |
Bir denetim tarafından ConnectionsZone oluşturulan bağlantı kullanıcı arabiriminin (UI) alt bölümü başlığı olarak görüntülenen metni alır veya ayarlar. |
| ConfigureVerb |
Bağlantı kullanıcı arabiriminde (UI) yapılandırma görünümünü açmak için kullanılan bir WebPartVerb nesneye başvuru alır. |
| ConnectToConsumerInstructionText |
Kullanıcıların sağlayıcının bağlanacağı bir tüketici bağlantı noktasını seçtiği bağlantı kullanıcı arabiriminin (UI) bölümünde görüntülenen yönerge metnini alır veya ayarlar. |
| ConnectToConsumerText |
Kullanıcıların bağlantı için tüketici denetimi seçebilecekleri bir görünümü açmak için tıkladığı köprü metnini alır veya ayarlar. |
| ConnectToConsumerTitle |
Bağlantı kullanıcı arabiriminde (UI) kullanıcıların bağlanacak belirli bir tüketiciyi seçebileceği bölümün başlık metnini alır veya ayarlar. |
| ConnectToProviderInstructionText |
Bağlantı kullanıcı arabiriminin (UI) bölümünde görüntülenen ve kullanıcıların tüketicinin bağlanacağı bir sağlayıcı bağlantı noktası seçtiği yönerge metnini alır veya ayarlar. |
| ConnectToProviderText |
Kullanıcıların bağlantı için sağlayıcı denetimi seçebilecekleri bir görünümü açmak için tıkladığı köprü metnini alır veya ayarlar. |
| ConnectToProviderTitle |
Bağlantı kullanıcı arabiriminde (UI) kullanıcıların bağlanmak için belirli bir sağlayıcı seçebileceği bölümün başlık metnini alır veya ayarlar. |
| ConnectVerb |
İki WebPart denetimin bağlantı kurmasını sağlayan bir WebPartVerb nesneye başvuru alır. |
| ConsumersInstructionText |
Bağlantı zaten mevcut olduğunda, bağlantı kullanıcı arabiriminin (UI) tüketiciler bölümünde gösterilen yönerge metnini alır veya ayarlar. |
| ConsumersTitle |
Bağlantı zaten mevcut olduğunda bağlantı kullanıcı arabiriminin (UI) tüketiciler bölümünde gösterilen başlığı alır veya ayarlar. |
| Context |
HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır. (Devralındığı yer: Control) |
| Controls |
içindeki alt denetimleri temsil eden bir ControlCollectionCompositeControlnesnesi alır. (Devralındığı yer: CompositeControl) |
| ControlStyle |
Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ControlStyleCreated |
Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CssClass |
İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar. (Devralındığı yer: WebControl) |
| DataItemContainer |
Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control) |
| DataKeysContainer |
Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control) |
| DesignMode |
Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| DisconnectVerb |
Kullanıcının bağlı WebPart iki denetimin bağlantısını kesmesini sağlayan bir nesneye başvuru WebPartVerb alır. |
| Display |
Bir denetimin şu anda görüntülenip görüntülenmediğini belirten bir ToolZone değer alır. |
| EditUIStyle |
Bir denetimde bulunan ToolZone düzenlenebilir denetimlerin stil özniteliklerini alır. (Devralındığı yer: ToolZone) |
| EmptyZoneText |
Web sayfasında bağlantı kurmak için yeterli denetim yoksa boş ConnectionsZone bir denetimde görüntülenen bir metin iletisi alır veya ayarlar. |
| EmptyZoneTextStyle |
Boş bir bölgedeki yer tutucu metnin stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| Enabled |
Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableTheming |
Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableViewState |
Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip getirmek olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| ErrorStyle |
Bir denetim yüklenemediğinde veya oluşturulamadığında WebPart görüntülenen hata iletisini işlemek için stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| Events |
Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır. (Devralındığı yer: Control) |
| ExistingConnectionErrorMessage |
Var olan bir bağlantıda hata veya uyarı olduğunda bağlantı kullanıcı arabiriminde (UI) görüntülenen iletinin metnini alır veya ayarlar. |
| Font |
Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır. (Devralındığı yer: WebControl) |
| FooterStyle |
Bir bölgenin alt bilgi alanının içeriği için stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| ForeColor |
Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar. (Devralındığı yer: WebControl) |
| GetFromText |
Bağlantı kullanıcı arabiriminin (UI) bir tüketicinin veri alacağı adlandırılmış sağlayıcıdan önce gelen bölümünde gösterilen metni alır veya ayarlar. |
| GetText |
Bağlantı kullanıcı arabiriminin (UI) bir sağlayıcıdan veri alacak adlandırılmış tüketiciden önce gelen bölümünde gösterilen metni alır veya ayarlar. |
| HasAttributes |
Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır. (Devralındığı yer: WebControl) |
| HasChildViewState |
Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| HasFooter |
Bir bölgenin alt bilgi alanına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: WebZone) |
| HasHeader |
Bir bölgenin üst bilgi alanına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: WebZone) |
| HeaderCloseVerb |
Denetimi kapatmak için WebPartVerb kullanılan bir ToolZone denetimin üst bilgisindeki nesneye başvuru alır. (Devralındığı yer: ToolZone) |
| HeaderStyle |
Bir bölgenin üst bilgi alanının içeriği için stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| HeaderText |
Denetim tarafından ConnectionsZone oluşturulan bağlantı kullanıcı arabiriminin (UI) en üstünde görünen üst bilgi metnini alır veya ayarlar. |
| HeaderVerbStyle |
Denetimde görüntülenen ToolZone tüm üst bilgi fiillerinin stil özniteliklerini alır. (Devralındığı yer: ToolZone) |
| Height |
Web sunucusu denetiminin yüksekliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
| ID |
Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar. (Devralındığı yer: Control) |
| IdSeparator |
Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır. (Devralındığı yer: Control) |
| InstructionText |
Mevcut bağlantıları yönetmek için bağlantı kullanıcı arabiriminin (UI) bölümünde seçili denetimle ilgili genel yönergeler için kullanılan metni alır veya ayarlar. |
| InstructionTextStyle |
Denetimin en üstünde ToolZone görünen yönerge metninin stil özniteliklerini alır. (Devralındığı yer: ToolZone) |
| InstructionTitle |
Mevcut bağlantıları yönetmek için bağlantı kullanıcı arabiriminde (UI) tüketici veya sağlayıcı denetiminde gerçekleştirilebilecek eylemin genel açıklaması için kullanılan metni alır veya ayarlar. |
| IsChildControlStateCleared |
Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| IsEnabled |
Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: WebControl) |
| IsTrackingViewState |
Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır. (Devralındığı yer: Control) |
| IsViewStateEnabled |
Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: Control) |
| LabelStyle |
Bir denetim içindeki düzenleme denetimleriyle ToolZone birlikte görünen etiketlerin içeriği için stil özniteliklerini alır. ve EditorZonegibi CatalogZone türetilmiş ToolZone denetimler, stilleri etiketlere uygular. (Devralındığı yer: ToolZone) |
| LoadViewStateByID |
Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| NamingContainer |
Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır. (Devralındığı yer: Control) |
| NewConnectionErrorMessage |
Kullanıcının oluşturmaya çalıştığı yeni bir bağlantıda hata veya uyarı olduğunda bağlantı kullanıcı arabiriminde (UI) görüntülenen ileti metnini alır veya ayarlar. |
| NoExistingConnectionInstructionText |
Web Bölümleri denetiminin mevcut bağlantısı olmadığında bağlantı kullanıcı arabiriminin (UI) gövdesinde görünen yönerge metnini alır veya ayarlar. |
| NoExistingConnectionTitle |
Web Bölümleri denetiminin mevcut bağlantısı olmadığında bağlantı kullanıcı arabiriminin (UI) gövdesinde görünen başlık metnini alır veya ayarlar. |
| Padding |
Bir bölgedeki denetimleri içeren WebPart tablodaki hücre doldurma özniteliklerini alır veya ayarlar. (Devralındığı yer: WebZone) |
| Page |
Sunucu denetimini içeren örneğe başvuru Page alır. (Devralındığı yer: Control) |
| Parent |
Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır. (Devralındığı yer: Control) |
| PartChromePadding |
Denetimin WebPart içeriğiyle denetimin kenarlığı arasındaki mesafeyi alır veya ayarlar. (Devralındığı yer: WebZone) |
| PartChromeStyle |
Bir bölgenin içerdiği Web Bölümleri denetimlerinin kenarlıklarına uygulanan stil özelliklerini alır. (Devralındığı yer: WebZone) |
| PartChromeType |
Bir denetimde yer alan ConnectionsZone sunucu denetimlerini çerçeveleyen kenarlık türünü alır veya ayarlar. |
| PartStyle |
Bir bölgenin içerdiği her Web Bölümü denetiminin kenarlık ve içeriğine uygulanan stil özelliklerini alır. (Devralındığı yer: WebZone) |
| PartTitleStyle |
Bir bölgenin içerdiği her Web Bölümü denetimi için başlık çubuğu içeriğinin stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| ProvidersInstructionText |
Bağlantı zaten mevcut olduğunda, bağlantı kullanıcı arabiriminin (UI) sağlayıcılar bölümünde gösterilen yönerge metnini alır veya ayarlar. |
| ProvidersTitle |
Bağlantı zaten mevcut olduğunda, bağlantı kullanıcı arabiriminin (UI) sağlayıcılar bölümünde gösterilen başlığı alır veya ayarlar. |
| RenderClientScript |
Web Bölümleri sayfasında istemci betiğinin işlenip işlenmeyeceğini belirten bir değer alır. (Devralındığı yer: WebZone) |
| RenderingCompatibility |
HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır. (Devralındığı yer: Control) |
| SendText |
Bir tüketiciye veri gönderecek adlandırılmış sağlayıcıdan önce gelen bağlantı kullanıcı arabiriminin (UI) bölümünde gösterilen metni alır veya ayarlar. |
| SendToText |
Bağlantı kullanıcı arabiriminin (UI) bir sağlayıcının veri göndereceği adlandırılmış tüketiciden önce gelen bölümünde gösterilen metni alır veya ayarlar. |
| Site |
Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır. (Devralındığı yer: Control) |
| SkinID |
Denetime uygulanacak kaplamayı alır veya ayarlar. (Devralındığı yer: WebControl) |
| Style |
Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır. (Devralındığı yer: WebControl) |
| SupportsDisabledAttribute |
Denetimin özelliği |
| TabIndex |
Web sunucusu denetiminin sekme dizinini alır veya ayarlar. (Devralındığı yer: WebControl) |
| TagKey |
HtmlTextWriterTag Bu Web sunucusu denetimine karşılık gelen değeri alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebZone) |
| TagName |
Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| TemplateControl |
Bu denetimi içeren şablona başvuru alır veya ayarlar. (Devralındığı yer: Control) |
| TemplateSourceDirectory |
Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır. (Devralındığı yer: Control) |
| ToolTip |
Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: WebControl) |
| UniqueID |
Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır. (Devralındığı yer: Control) |
| ValidateRequestMode |
Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| VerbButtonType |
Bir bölgedeki fiilleri temsil etmek için ne tür bir düğme kullanıldığını alır veya ayarlar. (Devralındığı yer: WebZone) |
| VerbStyle |
Bir bölgedeki Web Bölümleri denetimleriyle ilişkili kullanıcı arabirimi (UI) fiillerinin stil özniteliklerini alır. (Devralındığı yer: WebZone) |
| ViewState |
Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır. (Devralındığı yer: Control) |
| ViewStateIgnoresCase |
Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ViewStateMode |
Bu denetimin görünüm durumu modunu alır veya ayarlar. (Devralındığı yer: Control) |
| Visible |
Sunucu denetiminin sayfada kullanıcı arabirimi (UI) öğesi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: ToolZone) |
| WebPartManager |
Web Bölümleri sayfasındaki bir WebZone denetim örneğiyle ilişkili denetime başvuru WebPartManager alır. (Devralındığı yer: WebZone) |
| WebPartToConnect |
Bağlanmak için seçili WebPart durumdaki denetimi alır. |
| Width |
Web sunucusu denetiminin genişliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
Yöntemler
| AddAttributesToRender(HtmlTextWriter) |
Belirtilen HtmlTextWriterTagöğesine işlenmesi gereken HTML öznitelikleri ve stilleri ekler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| AddedControl(Control, Int32) |
Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control . (Devralındığı yer: Control) |
| AddParsedSubObject(Object) |
Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler. (Devralındığı yer: Control) |
| ApplyStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ApplyStyleSheetSkin(Page) |
Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular. (Devralındığı yer: Control) |
| BeginRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemeye başlar. (Devralındığı yer: Control) |
| BuildProfileTree(String, Boolean) |
Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace . (Devralındığı yer: Control) |
| ClearCachedClientID() |
Önbelleğe alınan ClientID değeri olarak |
| ClearChildControlState() |
Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildViewState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar. (Devralındığı yer: Control) |
| Close() |
Denetim tarafından oluşturulan bağlantı kullanıcı arabirimini ConnectionsZone (UI) kapatır. |
| CopyBaseAttributes(WebControl) |
Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CreateChildControls() |
Sunucuya geri gönderme veya işleme hazırlığında bir ConnectionsZone denetimde yer alan tüm alt denetimleri oluşturur. |
| CreateControlCollection() |
Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur. (Devralındığı yer: Control) |
| CreateControlStyle() |
Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| DataBind() |
Bir veri kaynağını CompositeControl ve tüm alt denetimlerine bağlar. (Devralındığı yer: CompositeControl) |
| DataBind(Boolean) |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar. (Devralındığı yer: Control) |
| DataBindChildren() |
Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar. (Devralındığı yer: Control) |
| Dispose() |
Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar. (Devralındığı yer: Control) |
| EndRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemesini sonlandırır. (Devralındığı yer: Control) |
| EnsureChildControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur. (Devralındığı yer: Control) |
| EnsureID() |
Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur. (Devralındığı yer: Control) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| FindControl(String) |
Belirtilen |
| FindControl(String, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen |
| Focus() |
Giriş odağını bir denetime ayarlar. (Devralındığı yer: Control) |
| GetDesignModeState() |
Denetim için tasarım zamanı verilerini alır. (Devralındığı yer: Control) |
| GetEffectiveChromeType(Part) |
Bölgenin özelliği ve Web Bölümleri sayfasının geçerli görüntüleme modu göz önünde bulundurularak PartChromeType denetimin gerçek veya geçerli geçerli PartChromeType değerini WebPart döndürür. (Devralındığı yer: WebZone) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetRouteUrl(Object) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(RouteValueDictionary) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, Object) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| GetUniqueIDRelativeTo(Control) |
Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür. (Devralındığı yer: Control) |
| HasControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. (Devralındığı yer: Control) |
| HasEvents() |
Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür. (Devralındığı yer: Control) |
| IsLiteralContent() |
Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler. (Devralındığı yer: Control) |
| LoadControlState(Object) |
yöntemi tarafından SaveControlState() kaydedilen önceki sayfa isteğinden denetim durumu bilgilerini geri yükler. |
| LoadViewState(Object) |
yöntemi tarafından SaveViewState() kaydedilen önceki bir sayfa isteğinden görünüm durumu bilgilerini geri yükler. |
| MapPathSecure(String) |
Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır. (Devralındığı yer: Control) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MergeStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler. (Devralındığı yer: Control) |
| OnDataBinding(EventArgs) |
Olayı tetikler DataBinding . (Devralındığı yer: Control) |
| OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) |
Olayı tetikler DisplayModeChanged . |
| OnInit(EventArgs) |
Olayı tetikler Init . |
| OnLoad(EventArgs) |
Olayı tetikler Load . (Devralındığı yer: Control) |
| OnPreRender(EventArgs) |
Olayı tetikler PreRender . (Devralındığı yer: WebZone) |
| OnSelectedWebPartChanged(Object, WebPartEventArgs) |
Olayı tetikler SelectedWebPartChanged . |
| OnUnload(EventArgs) |
Olayı tetikler Unload . (Devralındığı yer: Control) |
| OpenFile(String) |
Stream Bir dosyayı okumak için kullanılan alır. (Devralındığı yer: Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar. (Devralındığı yer: Control) |
| RaisePostBackEvent(String) |
Denetimi içeren form sunucuya ConnectionsZone geri gönderildiğinde denetim için bir olay oluşturur. |
| RecreateChildControls() |
alt denetimleri öğesinden CompositeControltüretilmiş bir denetimde yeniden oluşturur. (Devralındığı yer: CompositeControl) |
| RemovedControl(Control) |
Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control . (Devralındığı yer: Control) |
| Render(HtmlTextWriter) |
Denetimin ConnectionsZone içeriğini belirtilen HtmlTextWriter nesneye işler. |
| RenderBeginTag(HtmlTextWriter) |
Bölge denetiminin açılış HTML etiketini belirtilen HtmlTextWriter nesneye işler. (Devralındığı yer: WebZone) |
| RenderBody(HtmlTextWriter) |
Denetimin ConnectionsZone gövde alanının içeriğini, içeriği Web sayfasına yazan belirtilen HtmlTextWriter nesneye gönderir. |
| RenderChildren(HtmlTextWriter) |
Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar. (Devralındığı yer: Control) |
| RenderContents(HtmlTextWriter) |
Başlangıç ve bitiş etiketleri arasındaki bir bölge denetiminin tüm içeriğini belirtilen HtmlTextWriter nesneye işler. (Devralındığı yer: WebZone) |
| RenderControl(HtmlTextWriter) |
Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar. (Devralındığı yer: Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter . (Devralındığı yer: Control) |
| RenderEndTag(HtmlTextWriter) |
Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| RenderFooter(HtmlTextWriter) |
Denetimin alt bilgisindeki ToolZone fiilleri işlemek için temel yöntemi geçersiz kılar. (Devralındığı yer: ToolZone) |
| RenderHeader(HtmlTextWriter) |
Denetimlerin gerektirdiği ToolZone üst bilgi alanı için özelleştirilmiş işleme sağlamak için temel yöntemi geçersiz kılar. (Devralındığı yer: ToolZone) |
| RenderVerb(HtmlTextWriter, WebPartVerb) |
Tek bir fiili bir denetimle işler ToolZone . (Devralındığı yer: ToolZone) |
| RenderVerbs(HtmlTextWriter) |
Bir denetim için ConnectionsZone bölge düzeyinde fiilleri işler. |
| ResolveAdapter() |
Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır. (Devralındığı yer: Control) |
| ResolveClientUrl(String) |
Tarayıcı tarafından kullanılabilecek bir URL alır. (Devralındığı yer: Control) |
| ResolveUrl(String) |
URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür. (Devralındığı yer: Control) |
| SaveControlState() |
Sayfanın sunucuya son gönderildiğinden bu yana gerçekleşen Tüm Web Bölümleri denetim durumu değişikliklerini kaydeder. |
| SaveViewState() |
Bir denetimin ConnectionsZone sayfa sunucuya en son geri gönderildiğinden bu yana gerçekleşen görünüm durumu değişikliklerini kaydeder. |
| SetDesignModeState(IDictionary) |
Denetim için tasarım zamanı verilerini ayarlar. (Devralındığı yer: Control) |
| SetRenderMethodDelegate(RenderMethod) |
Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object) |
İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object, Object) |
İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
| TrackViewState() |
Denetimdeki görünüm durumu değişikliklerini ConnectionsZone izler, böylece değişiklikler denetimin StateBag nesnesinde depolanabilir. |
Ekinlikler
| DataBinding |
Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir. (Devralındığı yer: Control) |
| Disposed |
ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir. (Devralındığı yer: Control) |
| Init |
Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır. (Devralındığı yer: Control) |
| Load |
Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir. (Devralındığı yer: Control) |
| PreRender |
Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir. (Devralındığı yer: Control) |
| Unload |
Sunucu denetimi bellekten kaldırıldığında gerçekleşir. (Devralındığı yer: Control) |
Belirtik Arabirim Kullanımları
Uzantı Metotları
| FindDataSourceControl(Control) |
Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür. |
| FindFieldTemplate(Control, String) |
Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür. |
| FindMetaTable(Control) |
İçeren veri denetimi için metatablo nesnesini döndürür. |
| GetDefaultValues(INamingContainer) |
Belirtilen veri denetimi için varsayılan değerlerin koleksiyonunu alır. |
| GetMetaTable(INamingContainer) |
Belirtilen veri denetimi için tablo meta verilerini alır. |
| SetMetaTable(INamingContainer, MetaTable) |
Belirtilen veri denetimi için tablo meta verilerini ayarlar. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Tablo meta verilerinin kullanılabilir olup olmadığını belirler. |
| EnableDynamicData(INamingContainer, Type) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |
| EnableDynamicData(INamingContainer, Type, Object) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin