ScriptManager 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.
Web ve uygulama hizmetleri için ASP.NET Ajax betik kitaplıklarını ve betik dosyalarını, kısmi sayfa işlemeyi ve istemci proxy sınıfı oluşturmayı yönetir.
public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
inherit Control
interface IPostBackDataHandler
interface IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- Devralma
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki örneklerde denetimi kullanmaya yönelik farklı senaryolar gösterilmektedir ScriptManager .
Partial-Page Güncelleştirmelerini Etkinleştirme
Aşağıdaki örnekte, kısmi sayfa güncelleştirmelerini etkinleştirmek için denetimin ScriptManager nasıl kullanılacağı gösterilmektedir. Bu örnekte, ve Calendar denetimi bir DropDownListUpdatePanel denetimin içindedir. Varsayılan olarak, özelliğinin UpdateMode değeri ve Alwaysözelliğinin ChildrenAsTriggers değeri şeklindedir true. Bu nedenle, panelin alt denetimleri zaman uyumsuz geri göndermeye neden olur.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void DropDownSelection_Change(Object sender, EventArgs e)
{
Calendar1.DayStyle.BackColor =
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
protected void Calendar1_SelectionChanged(object sender, EventArgs e)
{
SelectedDate.Text =
Calendar1.SelectedDate.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
Calendar1.DayStyle.BackColor = _
System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
End Sub
Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
SelectedDate.Text = Calendar1.SelectedDate.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
Partial-Page Güncelleştirme Hatalarını İşleme ve Betik Kaydetme
Aşağıdaki örnek, kısmi sayfa güncelleştirmeleri sırasında özel hata işleme sağlamayı gösterir. Varsayılan olarak, kısmi sayfa güncelleştirmeleri sırasında bir hata oluştuğunda bir JavaScript ileti kutusu görüntülenir. Bu örnek, olay için AsyncPostBackError bir işleyici sağlayarak ve olay işleyicisinde özelliğini ayarlayarak özel hata işlemenin AsyncPostBackErrorMessage nasıl kullanılacağını gösterir. Özelliği, kısmi sayfa güncelleştirmeleri sırasında bir hata oluştuğunda Web.config dosyasının özel hatalar bölümünün nasıl kullanılacağını belirtmek için de ayarlayabilirsiniz AllowCustomErrorsRedirect . Bu örnekte özelliğin varsayılan değeri AllowCustomErrorsRedirect kullanılır. Başka bir deyişle, Web.config dosyası customErrors öğesi içeriyorsa, bu öğe hataların nasıl görüntüleneceğini belirler. Daha fazla bilgi için bkz . customErrors Öğesi (ASP.NET Ayarlar Şeması).
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
try
{
int a = Int32.Parse(TextBox1.Text);
int b = Int32.Parse(TextBox2.Text);
int res = a / b;
Label1.Text = res.ToString();
}
catch (Exception ex)
{
if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
{
ex.Data["ExtraInfo"] = " You can't divide " +
TextBox1.Text + " by " + TextBox2.Text + ".";
}
throw ex;
}
}
protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
{
if (e.Exception.Data["ExtraInfo"] != null)
{
ScriptManager1.AsyncPostBackErrorMessage =
e.Exception.Message +
e.Exception.Data["ExtraInfo"].ToString();
}
else
{
ScriptManager1.AsyncPostBackErrorMessage =
"An unspecified error occurred.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Try
Dim a As Int32
a = Int32.Parse(TextBox1.Text)
Dim b As Int32
b = Int32.Parse(TextBox2.Text)
Dim res As Int32 = a / b
Label1.Text = res.ToString()
Catch ex As Exception
If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
ex.Data("ExtraInfo") = " You can't divide " & _
TextBox1.Text & " by " & TextBox2.Text & "."
End If
Throw ex
End Try
End Sub
Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
If (e.Exception.Data("ExtraInfo") <> Nothing) Then
ScriptManager1.AsyncPostBackErrorMessage = _
e.Exception.Message & _
e.Exception.Data("ExtraInfo").ToString()
Else
ScriptManager1.AsyncPostBackErrorMessage = _
"An unspecified error occurred."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
Tarayıcıda Görüntülenen Tarih ve Saati Genelleştirme
Aşağıdaki örnekte, istemci betiğinin EnableScriptGlobalization tarayıcıda kültüre özgü bir tarih ve saat görüntüleyebilmesi için özelliğinin nasıl ayarlanacağı gösterilmektedir. Örnekte@ CulturePage yönergesinin özniteliği olarak autoayarlanmıştır. Sonuç olarak, geçerli tarayıcı ayarlarında belirtilen ilk dil sayfanın kültürünü ve kullanıcı arabirimi kültürünü belirler. Daha fazla bilgi için bkz . Nasıl yapılır: ASP.NET Web Sayfası Genelleştirmesi için Kültür ve Kullanıcı Arabirimi Kültürünü Ayarlama.
<%@ Page Language="C#" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
Açıklamalar
Bu konuda:
Introduction
Denetim ScriptManager , ASP.NET'da Ajax işlevselliğinin merkezindedir. Denetim, sayfadaki tüm ASP.NET Ajax kaynaklarını yönetir. Bu, Microsoft Ajax Kitaplığı betiklerini tarayıcıya indirmeyi ve denetimleri kullanarak UpdatePanel etkinleştirilen kısmi sayfa güncelleştirmelerini koordine etme özelliğini içerir. Ayrıca, ScriptManager denetim aşağıdakileri yapmanızı sağlar:
Kısmi sayfa güncelleştirmeleriyle uyumlu betiği kaydedin. Betiğinizle çekirdek kitaplığı arasındaki bağımlılıkları yönetmek için, kaydettiğiniz tüm betikler Microsoft Ajax Kitaplığı betiğinden sonra yüklenir.
Sürüm veya hata ayıklama betiklerinin tarayıcıya gönderilip gönderilmeyeceğini belirtin.
Web hizmetlerini denetime kaydederek betikten Web hizmeti yöntemlerine ScriptManager erişim sağlayın.
Bu hizmetleri denetime ScriptManager kaydederek istemci betiğinden ASP.NET kimlik doğrulaması, rol ve profil uygulama hizmetlerine erişim sağlayın.
Tarayıcıda ECMAScript (JavaScript) Tarih, Sayı ve Dize işlevlerinin kültüre özgü görüntülenmesini etkinleştirin.
Denetimin özelliğini kullanarak ResourceUICultures ekli betik dosyaları veya tek başına betik dosyaları için yerelleştirme kaynaklarına erişin ScriptReference .
İstemci bileşenleri ve davranışları için gereken betiğin ScriptManager işlenmesi için denetimiyle veya IScriptControl arabirimlerini uygulayan IExtenderControl sunucu denetimlerini kaydedin.
Partial-Page İşleme
bir ASP.NET sayfasının kısmi sayfa işlemeyi destekleme özelliği aşağıdaki faktörler tarafından denetlenilir:
Denetimin ScriptManagerEnablePartialRendering özelliği (varsayılan değer) olmalıdır
true.Sayfada en az bir UpdatePanel denetim olmalıdır.
SupportsPartialRendering özelliği (varsayılan değer) olmalıdır
true. SupportsPartialRendering Özellik açıkça ayarlanmadıysa, değeri tarayıcı özelliklerine bağlıdır.
Sayfanın Init olayı sırasında veya öncesinde çalışma zamanında özelliğinin değerini EnablePartialRendering geçersiz kılabilirsiniz. Sayfanın Init olayı gerçekleştikten sonra bu özelliği değiştirmeye çalışırsanız, bir InvalidOperationException özel durum oluşturulur.
Kısmi sayfa işleme desteklendiğinde, ScriptManager denetim zaman uyumsuz geri göndermeleri ve kısmi sayfa güncelleştirmelerini etkinleştirmek için betiği işler. Güncelleştirilecek sayfanın bölgeleri denetimler kullanılarak UpdatePanel belirlenir. Denetim ScriptManager , zaman uyumsuz geri göndermeleri işler ve sayfanın yalnızca güncelleştirililmesi gereken bölgelerini yeniler. Kısmi sayfa işleme hakkında daha fazla bilgi için bkz. Partial-Page İşlemeye Genel Bakış. Güncelleştirmeye neden olan koşullar hakkında daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış.
ScriptManager Denetimini Ana Sayfalar, Kullanıcı Denetimleri ve Diğer Alt Bileşenlerle Kullanma
Bir sayfa hiyerarşisinde yalnızca bir ScriptManager denetim içerebilir. Üst sayfanın zaten bir ScriptManager denetimi olduğunda iç içe sayfalar, kullanıcı denetimleri veya bileşenler için hizmetleri ve betikleri kaydetmek için denetimi kullanın ScriptManagerProxy . Daha fazla bilgi için bkz. Ana Sayfalarla UpdatePanel Denetimini Kullanma.
Betik Yönetimi ve Kaydı
Denetim, ScriptManager daha sonra sayfanın bir parçası olarak işlenen betiği kaydetmenizi sağlar. Denetim ScriptManager kayıt yöntemleri aşağıdaki üç kategoriye ayrılabilir:
Microsoft Ajax Kitaplığı'nda betik bağımlılıklarının korunduğunu garanti eden kayıt yöntemleri.
Microsoft Ajax Kitaplığı'na bağımlı olmayan ancak denetimlerle UpdatePanel uyumlu kayıt yöntemleri.
Denetimlerle UpdatePanel çalışmayı destekleyen kayıt yöntemleri.
ASP.NET'da Ajax betiği oluşturma ve kullanma hakkında daha fazla bilgi için bkz. Microsoft Ajax Kitaplığı'nı Kullanarak Özel İstemci Betiği Oluşturma.
Microsoft Ajax Kitaplığına Bağımlı Betik Kaydetme
Betik dosyalarını Microsoft Ajax Kitaplığı'ndaki tüm bağımlılıkların korunduğunu garanti eden bir şekilde kaydetmek için aşağıdaki yöntemleri kullanabilirsiniz.
| Yöntem | Tanım |
|---|---|
| RegisterScriptControl | Sys.Component istemci nesnesini tanımlamak için kullanılan arabirimi uygulayan IScriptControl bir sunucu denetimini kaydeder. Denetim, ScriptManager istemci nesnesini destekleyen betiği işler. |
| RegisterExtenderControl | Sys.Component istemci nesnesini tanımlamak için kullanılan arabirimi uygulayan IExtenderControl bir sunucu denetimini kaydeder. Denetim, ScriptManager istemci nesnesini destekleyen betiği işler. |
Uyumlu Betikleri Partial-Page Kaydetme
Microsoft Ajax Kitaplığı'na bağımlı olmayan ancak denetimlerle UpdatePanel uyumlu betik dosyalarını kaydetmek için aşağıdaki yöntemleri kullanabilirsiniz. Bu yöntemler, denetimin benzer yöntemlerine ClientScriptManager karşılık gelir. Bir UpdatePanel denetimin içinde kullanmak üzere betik işleniyorsa, denetimin yöntemlerini çağırdığınızdan ScriptManager emin olun.
| Yöntem | Tanım |
|---|---|
| RegisterArrayDeclaration | JavaScript dizisine değer ekler. Dizi yoksa oluşturulur. |
| RegisterClientScriptBlock | Sayfanın açılış <form> etiketinden sonra bir script öğeyi işler. Betik bir dize parametresi olarak belirtilir. |
| RegisterClientScriptInclude | Sayfanın açılış <form> etiketinden sonra bir script öğeyi işler. Betik içeriği, özniteliği bir betik dosyasına işaret eden bir URL'ye ayarlanarak src belirtilir. |
| RegisterClientScriptResource | Sayfanın açılış <form> etiketinden sonra bir script öğeyi işler. Betik içeriği bir derlemedeki kaynak adıyla belirtilir.
src Özniteliği, adlandırılmış betiği derlemeden alan bir HTTP işleyicisine yapılan çağrıyla otomatik olarak bir URL ile doldurulur. |
| RegisterExpandoAttribute | Belirtilen denetim için işaretlemede özel bir ad/değer öznitelik çifti (bir expando) oluşturur. |
| RegisterHiddenField | Gizli bir alanı işler. |
| RegisterOnSubmitStatement | Öğenin submit olayına form yanıt olarak yürütülen bir betiği kaydeder. özniteliği belirtilen onSubmit betike başvurur. |
| RegisterStartupScript | Sayfanın kapanış </form> etiketinden hemen önce bir başlangıç betiği bloğunu işler. İşlenmek üzere betik bir dize parametresi olarak belirtilir. |
Yöntemleri kaydederken, bu betik için bir tür/anahtar çifti belirtirsiniz. Aynı tür/anahtar çifti olan bir betik zaten kayıtlıysa, yeni bir betik kaydedilmez. Benzer şekilde, zaten var olan bir tür/kaynak adı çifti ile bir betik kaydederseniz, script kaynağa başvuran öğe yeniden eklenmez. Daha önce kaydedilmiş bir özniteliğin expando özniteliğini kaydettiğinizde, bir özel durum oluşturulur. Dizi değerlerinin yinelenen kaydına izin verilir.
veya RegisterClientScriptResource yöntemini çağırdığınızdaRegisterClientScriptInclude, satır içi işlevleri yürüten betiği kaydetmekten kaçının. Bunun yerine, uygulamanız için olay işleyicileri veya özel sınıf tanımları gibi işlev tanımlarını içeren betiği kaydedin.
UpdatePanel Denetimleri için Kayıt Yöntemleri
Denetimleri kullanırken UpdatePanel kısmi sayfa güncelleştirmelerini özelleştirmek için aşağıdaki yöntemleri kullanabilirsiniz.
| Yöntem | Tanım |
|---|---|
| RegisterAsyncPostBackControl | Zaman uyumsuz geri göndermeler için bir denetimi tetikleyici olarak kaydeder. |
| RegisterDataItem | Kısmi sayfa işleme sırasında denetimlere özel veriler gönderir. |
| RegisterDispose | Bir denetimin içindeki UpdatePanel denetim için dispose betiğini kaydeder. Denetim güncelleştirildiğinde veya silindiğinde UpdatePanel betik yürütülür. Dispose yöntemi, Microsoft Ajax Kitaplığı'nın parçası olan ve bir bileşen artık kullanılmadığında kaynakları boşaltması gereken istemci bileşenleri için kullanılır. |
| RegisterPostBackControl | Tam geri gönderme için bir denetimi tetikleyici olarak kaydeder. Bu yöntem, aksi takdirde zaman uyumsuz geri göndermeler gerçekleştirecek bir UpdatePanel denetimin içindeki denetimler için kullanılır. |
Web Hizmeti Başvuruları
Bir nesne oluşturup denetimin koleksiyonuna ScriptManager ekleyerek Services istemci betiğinden çağrılacak bir ServiceReference Web hizmetini kaydedebilirsiniz. ASP.NET koleksiyondaki Services her ServiceReference nesne için bir istemci proxy nesnesi oluşturur. Web hizmetlerini çalışma zamanında kaydetmek için koleksiyona Services program aracılığıyla nesneler ekleyebilirsinizServiceReference.
Betikteki Web hizmetlerine erişme hakkında daha fazla bilgi için bkz. ASP.NET AJAX'ta Web Hizmetlerini İstemci Betiğine Sunma ve ASP.NET AJAX'ta İstemci Betiğinden Web Hizmetlerini Çağırma.
Localization
Denetim, ScriptManager işlenen sayfada derlemelere katıştırılmış betik dosyaları veya tek başına betik dosyaları olan uygun yerelleştirilmiş betik dosyalarına işaret eden başvurular oluşturur.
EnableScriptLocalization özelliği olarak trueScriptManager ayarlandığında, denetim varsa geçerli kültür için yerelleştirilmiş kaynakları (yerelleştirilmiş dizeler gibi) alır. Denetim ScriptManager , yerelleştirilmiş kaynakları kullanmak için aşağıdaki işlevleri sağlar:
Bir derlemeye eklenmiş betik dosyaları. Denetim, ScriptManager tarayıcıya hangi kültüre özgü veya geri dönüş kültürü betik dosyasının gönderileceğini belirler. Bunu, kültüre özgü NeutralResourcesLanguageAttribute derleme özniteliğini, derlemeyle paketlenmiş kaynakları ve tarayıcının kullanıcı arabirimi kültürünü (varsa) kullanarak yapar.
Tek başına betik dosyaları. Denetim, ScriptManager nesnesinin özelliği kullanılarak ResourceUICultures desteklenen ui kültürlerinin ScriptReference listesini tanımlar.
Hata ayıklama modunda. Denetim, ScriptManager hata ayıklama bilgilerini içeren kültüre özgü bir betik dosyasını işlemeye çalışır. Örneğin, sayfa hata ayıklama modundaysa ve geçerli kültür en-MXolarak ayarlandıysa, denetim, dosya varsa.en-MX.debug.jsgibi
scriptnamebir ada sahip bir betik dosyası işler. Dosya yoksa, uygun geri dönüş kültürü için hata ayıklama dosyası işlenir
Kaynakları yerelleştirme hakkında daha fazla bilgi için bkz. Bileşen Kitaplıkları için Kaynakları Yerelleştirmeye Genel Bakış.
Hata İşleme
Zaman uyumsuz geri göndermeler sırasında bir sayfa hatası oluştuğunda AsyncPostBackError , olay oluşturulur. Sunucudaki hataların istemciye gönderilme şekli, Web.config dosyasının özelliğine, özelliğine AsyncPostBackErrorMessage ve özel hatalar bölümüne bağlıdırAllowCustomErrorsRedirect. Daha fazla bilgi için bkz. UpdatePanel Denetimleri için Hata İşlemeyi Özelleştirme.
Bildirim Temelli Söz Dizimi
<asp:ScriptManager
AllowCustomErrorsRedirect="True|False"
AsyncPostBackErrorMessage="string"
AsyncPostBackTimeout="integer"
AuthenticationService-Path="uri"
EnablePageMethods="True|False"
EnablePartialRendering="True|False"
EnableScriptGlobalization="True|False"
EnableScriptLocalization="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
LoadScriptsBeforeUI="True|False"
OnAsyncPostBackError="AsyncPostBackError event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnResolveScriptReference="ResolveScriptReference event handler"
OnUnload="Unload event handler"
ProfileService-LoadProperties="string"
ProfileService-Path="uri"
RoleService-LoadRoles="True|False"
RoleService-Path="uri"
runat="server"
ScriptMode="Auto|Inherit|Debug|Release"
ScriptPath="string"
SkinID="string"
SupportsPartialRendering="True|False"
Visible="True|False"
>
<AuthenticationService
Path="uri"
/>
<ProfileService
LoadProperties="string"
Path="uri"
/>
<RoleService
LoadRoles="True|False"
Path="uri"
/>
<Scripts>
<asp:ScriptReference
Assembly="string"
IgnoreScriptPath="True|False"
Name="string"
NotifyScriptLoaded="True|False"
Path="string"
ResourceUICultures="string"
ScriptMode="Auto|Debug|Inherit|Release"
/>
</Scripts>
<Services>
<asp:ServiceReference
InlineScript="True|False"
Path="string"
/>
</Services>
</asp:ScriptManager>
Oluşturucular
| Name | Description |
|---|---|
| ScriptManager() |
ScriptManager sınıfının yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| Adapter |
Denetim için tarayıcıya özgü bağdaştırıcıyı alır. (Devralındığı yer: Control) |
| AjaxFrameworkAssembly |
Sayfadaki bileşenlerin kullandığı Ajax çerçeve derlemesini alır. |
| AjaxFrameworkMode |
Microsoft Ajax istemci kitaplığının istemci betiklerinin istemciye nasıl dahil olacağını belirten bir değer alır veya ayarlar. |
| AllowCustomErrorsRedirect |
Web.config dosyasının özel hatalar bölümünün zaman uyumsuz geri göndermedeki bir hata sırasında kullanılıp kullanılmadığını belirleyen bir değer alır veya ayarlar. |
| AppRelativeTemplateSourceDirectory |
Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar. (Devralındığı yer: Control) |
| AsyncPostBackErrorMessage |
Zaman uyumsuz geri gönderme sırasında işlenmeyen bir sunucu özel durumu oluştuğunda istemciye gönderilen hata iletisini alır veya ayarlar. |
| AsyncPostBackSourceElementID |
Zaman uyumsuz geri göndermeye neden olan denetimin benzersiz kimliğini alır. |
| AsyncPostBackTimeout |
Yanıt alınmazsa zaman uyumsuz geri gönderme zaman aşımına uğramadan önce geçen süreyi saniye olarak belirten bir değer alır veya ayarlar. |
| AuthenticationService |
AuthenticationServiceManager Geçerli ScriptManager örnekle ilişkili nesneyi alır. |
| BindingContainer |
Bu denetimin veri bağlamasını içeren denetimi alır. (Devralındığı yer: Control) |
| 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) |
| ClientNavigateHandler |
İstemcide Sys.Application.navigate olayını işleyen yöntemin adını alır veya ayarlar. |
| CompositeScript |
Web sayfasını destekleyen bileşik betik başvurusu alır. |
| Context |
HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır. (Devralındığı yer: Control) |
| Controls |
ControlCollection Kullanıcı arabirimi hiyerarşisinde belirtilen bir sunucu denetimi için alt denetimleri temsil eden bir nesne alır. (Devralındığı yer: Control) |
| DataItemContainer |
Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına başvuru alır. (Devralındığı yer: Control) |
| DataKeysContainer |
Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına 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) |
| EmptyPageUrl |
Boş bir Web sayfasının URL'sini alır veya ayarlar. |
| EnableCdn |
Geçerli sayfanın CDN (Content Delivery Network) yollarından istemci betik başvurularını yükleyip yüklemediğini belirler. |
| EnableCdnFallback |
CDN'nin (Content Delivery Network) kullanılamadığı durumlarda betiğin yerel kopyasının yüklenmesini sağlar. |
| EnableHistory |
Web sayfasının geçmiş noktası yönetimini destekleyip desteklemediğini gösteren bir değer alır veya ayarlar. |
| EnablePageMethods |
bir ASP.NET sayfasındaki genel statik sayfa yöntemlerinin istemci betiğinden çağrılabileceğini gösteren bir değer alır veya ayarlar. |
| EnablePartialRendering |
Sayfanın kısmi işlenmesini sağlayan bir değer alır veya ayarlar; bu da denetimleri kullanarak UpdatePanel sayfanın bölgelerini tek tek güncelleştirmenizi sağlar. |
| EnableScriptGlobalization |
Denetimin kültüre ScriptManager özgü bilgilerin ayrıştırma ve biçimlendirmesini destekleyen betiği işleyip işlemediğini gösteren bir değer alır veya ayarlar. |
| EnableScriptLocalization |
Denetimin betik dosyalarının ScriptManager yerelleştirilmiş sürümlerini işleyip işlemediğini gösteren bir değer alır veya ayarlar. |
| EnableSecureHistoryState |
Geçmiş durum dizesinin şifrelenip şifreleneceğini belirten bir değer alır veya ayarlar. |
| EnableTheming |
Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| 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 taşımadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| Events |
Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunurdur. (Devralındığı yer: Control) |
| 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) |
| ID |
Sunucu denetimine atanan programlı tanımlayıcıyı 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) |
| IsChildControlStateCleared |
Bu denetimin içindeki denetimlerin denetim durumuna sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| IsDebuggingEnabled |
İstemci betik kitaplıklarının hata ayıklama sürümlerinin işlenip işlenmeyeceğini gösteren bir değer alır. |
| IsInAsyncPostBack |
Geçerli geri göndermenin kısmi işleme modunda yürütüldüğünü gösteren bir değer alır. |
| IsNavigating |
Bir olayın şu anda işlenip işlenmediğini gösteren bir Navigate değer alır. |
| 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 gösteren bir değer alır. (Devralındığı yer: Control) |
| LoadScriptsBeforeUI |
Sayfa kullanıcı arabirimi için işaretlemeden önce veya sonra betiklerin yüklenip yüklenmediğini gösteren bir değer alır veya ayarlar. |
| LoadViewStateByID |
Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| NamingContainer |
Aynı ID ö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 başvuru alır. (Devralındığı yer: Control) |
| Page |
Sunucu denetimini içeren örneğe başvuru Page alır. (Devralındığı yer: Control) |
| Parent |
Sayfa denetimi hiyerarşisinde sunucu denetiminin üst denetimine başvuru alır. (Devralındığı yer: Control) |
| ProfileService |
ProfileServiceManager Geçerli ScriptManager örnekle ilişkili nesneyi alır. |
| RenderingCompatibility |
HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır. (Devralındığı yer: Control) |
| RoleService |
RoleServiceManager Geçerli ScriptManager örnekle ilişkili nesneyi alır. |
| ScriptMode |
İstemci betik kitaplıklarının hata ayıklama veya sürüm sürümlerinin işlenip işlenmeyeceğini belirten bir değer alır veya ayarlar. |
| ScriptPath |
Geçersiz.
Ajax ve özel betik dosyalarını ASP.NET yollarını oluşturmak için kullanılan konumun kök yolunu alır veya ayarlar. |
| ScriptResourceMapping |
Bir ScriptResourceMapping nesnesi alır. |
| Scripts |
Her biri istemciye ScriptReference işlenen bir ScriptReferenceCollection betik dosyasını temsil eden nesneleri içeren bir nesne alır. |
| Services |
ServiceReferenceCollection Ajax işlevselliği için istemcide kullanıma sunan ASP.NET her Web hizmeti için bir nesne içeren bir ServiceReference nesne alır. |
| 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: Control) |
| SupportsPartialRendering |
İstemcinin kısmi sayfa işlemeyi destekleyip desteklemediğini gösteren bir değer alır. |
| 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) |
| UniqueID |
Sunucu denetimi için benzersiz, hiyerarşik 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 gösteren bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| 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 duyarsız 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 |
Bu değerin ayarlanmasını Visible önlemek için temel Control sınıftan devralınan özelliği geçersiz kılar. |
Yöntemler
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control . (Devralındığı yer: Control) |
| AddHistoryPoint(NameValueCollection, String) |
Belirtilen durum verisi toplama ve durum başlığını kullanarak bir geçmiş noktası oluşturur ve bunu tarayıcının geçmiş yığınına ekler. |
| AddHistoryPoint(String, String, String) |
Belirtilen durum anahtarını, durum değerini ve durum başlığını kullanarak bir geçmiş noktası oluşturur ve bunu tarayıcının geçmiş yığınına ekler. |
| AddHistoryPoint(String, String) |
Belirtilen durum anahtarını ve durum değerini kullanarak bir geçmiş noktası oluşturur ve bunu tarayıcının geçmiş yığınına ekler. |
| 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) |
| 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) |
| CreateChildControls() |
ASP.NET sayfa çerçevesi tarafından çağrılarak, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için kullanılır. (Devralındığı yer: Control) |
| 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) |
| DataBind() |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar. (Devralındığı yer: Control) |
| 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() |
Bir sunucu denetiminin bellekten çıkmadan önce son temizlemeyi gerçekleştirmesini sağlar. (Devralındığı yer: Control) |
| EndRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemeyi 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, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen |
| FindControl(String) |
Belirtilen |
| Focus() |
Giriş odağını bir denetime ayarlar. (Devralındığı yer: Control) |
| GetCurrent(Page) |
Belirli Page bir nesnenin ScriptManager örneğini alır. |
| GetDesignModeState() |
Denetim için tasarım zamanı verilerini alır. (Devralındığı yer: Control) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetRegisteredArrayDeclarations() |
Daha önce nesnesine Page kaydedilmiş ECMAScript (JavaScript) dizi bildirimlerinden oluşan salt okunur bir koleksiyon alır. |
| GetRegisteredClientScriptBlocks() |
Daha önce denetime ScriptManager kaydedilmiş istemci betik bloklarından oluşan salt okunur bir koleksiyon alır. |
| GetRegisteredDisposeScripts() |
Daha önce nesnesiyle Page kaydedilmiş olan betiklerden oluşan |
| GetRegisteredExpandoAttributes() |
Daha önce nesneye Page kaydedilmiş özel (expando) özniteliklerden oluşan salt okunur bir koleksiyon alır. |
| GetRegisteredHiddenFields() |
Daha önce nesneye Page kaydedilmiş gizli alanlardan oluşan salt okunur bir koleksiyon alır. |
| GetRegisteredOnSubmitStatements() |
Daha önce nesnesine Page kaydedilmiş deyimlerin salt okunur bir koleksiyonunu |
| GetRegisteredStartupScripts() |
Daha önce nesnesine Page kaydedilmiş başlangıç betiklerinden oluşan salt okunur bir koleksiyon alır. |
| 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) |
| GetStateString() |
Web sayfasının durumunu temsil eden anahtar/değer çiftleri içeren bir dize alır. |
| GetType() |
Geçerli örneğin Type 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 belirten bir değer döndürür. (Devralındığı yer: Control) |
| IsLiteralContent() |
Sunucu denetiminin yalnızca değişmez içeriği 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. (Devralındığı yer: Control) |
| LoadPostData(String, NameValueCollection) |
Tarayıcıdan sunucuya gönderilen form verilerini okur ve zaman uyumsuz geri göndermenin kaynağını belirler. |
| LoadViewState(Object) |
Yöntemi tarafından SaveViewState() kaydedilen önceki sayfa isteğinden görünüm durumu bilgilerini geri yükler. (Devralındığı yer: Control) |
| MapPathSecure(String) |
Bir sanal yolun mutlak veya göreli olarak eşlenin fiziksel yolunu alır. (Devralındığı yer: Control) |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Olayı tetikler AsyncPostBackError . |
| OnBubbleEvent(Object, EventArgs) |
Sunucu denetimi olayının sayfanın UI sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler. (Devralındığı yer: Control) |
| OnDataBinding(EventArgs) |
Olayı tetikler DataBinding . (Devralındığı yer: Control) |
| OnInit(EventArgs) |
Olayı yükseltir Init ve sayfada yalnızca bir ScriptManager denetimin var olduğundan emin olur. |
| OnLoad(EventArgs) |
Olayı tetikler Load . (Devralındığı yer: Control) |
| OnPreRender(EventArgs) |
PreRender Olayı başlatır ve kısmi sayfa güncelleştirmeleri için betik dosyalarını ve hizmetlerini kaydeder. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Olayı tetikler ResolveCompositeScriptReference . |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
Denetim tarafından yönetilen her betik başvurusu için olayı tetikler ResolveScriptReferenceScriptManager . |
| 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) |
Denetim tarafından ScriptManager tetiklenen bir geri gönderme olayını işler ve Web sayfasının geçmiş durumunu yükler. |
| RaisePostDataChangedEvent() |
Sunucuya ScriptManager geri gönderildiğinde denetim için olaylar oluşturur. |
| RegisterArrayDeclaration(Control, String, String) |
EcMAScript (JavaScript) dizi bildirimini ScriptManager denetimin içindeki UpdatePanel bir denetimle kullanmak üzere denetime kaydeder ve diziyi sayfaya ekler. |
| RegisterArrayDeclaration(Page, String, String) |
EcMAScript (JavaScript) dizi bildirimini ScriptManager denetimin içindeki UpdatePanel bir denetimle kullanmak üzere denetime kaydeder ve diziyi sayfaya ekler. |
| RegisterAsyncPostBackControl(Control) |
Zaman uyumsuz geri göndermeler için bir denetimi tetikleyici olarak kaydeder. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimine bir UpdatePanel istemci betik bloğu kaydeder ve ardından betik bloğunu sayfaya ekler. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimine bir UpdatePanel istemci betik bloğu kaydeder ve ardından betik bloğunu sayfaya ekler. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimiyle bir UpdatePanel istemci betik dosyası kaydeder ve sonra sayfaya bir betik dosyası başvurusu ekler. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Zaman uyumsuz bir geri gönderme gerçekleştiğinde istemci betiğini denetime ScriptManager kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler. |
| RegisterClientScriptResource(Control, Type, String) |
Kısmi sayfa işlemeye katılan bir denetimle ScriptManager kullanmak üzere bir derlemeye katıştırılmış istemci betiğini kaydeder. |
| RegisterClientScriptResource(Page, Type, String) |
Geri gönderme her gerçekleştiğinde denetimle birlikte bir derlemeye ScriptManager eklenmiş bir istemci betik dosyasını kaydeder. |
| RegisterDataItem(Control, String, Boolean) |
Kısmi sayfa işleme sırasında bir denetime özel veri gönderir ve verilerin JavaScript Nesne Gösterimi (JSON) biçiminde olup olmadığını gösterir. |
| RegisterDataItem(Control, String) |
Kısmi sayfa işleme sırasında bir denetime özel veriler gönderir. |
| RegisterDispose(Control, String) |
Denetimin |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Bir ad/değer çiftini denetimle belirtilen denetimin ScriptManager özel (expando) özniteliği olarak kaydeder. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Geçerli ScriptManager örneğe bir genişletici denetimi kaydeder. |
| RegisterHiddenField(Control, String, String) |
Gizli bir alanı, denetimin ScriptManager içindeki UpdatePanel bir denetimin denetimine kaydeder. |
| RegisterHiddenField(Page, String, String) |
Her zaman uyumsuz geri gönderme sırasında gizli bir alanı denetime ScriptManager kaydeder. |
| RegisterNamedClientScriptResource(Control, String) |
İstemci betiğini, kısmi sayfa işlemeye katılan bir denetimle ScriptManager kullanım denetimiyle birlikte bir derlemeye eklenmiş olan kaynak adına göre kaydeder. |
| RegisterNamedClientScriptResource(Page, String) |
İstemci betiğini, kısmi sayfa işlemeye katılan bir denetimle ScriptManager kullanım denetimiyle birlikte bir derlemeye eklenmiş olan kaynak adına göre kaydeder. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Form gönderildiğinde yürütülen bir denetimle ScriptManager birlikte kullanılan denetimin denetimine UpdatePanel ECMAScript (JavaScript) kodunu kaydeder. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Form gönderildiğinde yürütülen bir denetimle ScriptManager birlikte kullanılan denetimin denetimine UpdatePanel ECMAScript (JavaScript) kodunu kaydeder. |
| RegisterPostBackControl(Control) |
Bir denetimi geri gönderme için tetikleyici olarak kaydeder. Bu yöntem, aksi takdirde zaman uyumsuz geri göndermeler gerçekleştirecek bir UpdatePanel denetimin içinde geri gönderme denetimlerini yapılandırmak için kullanılır. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Geçerli ScriptManager örneğe bir betik denetimi kaydeder. |
| RegisterScriptDescriptors(IExtenderControl) |
bir ExtenderControl istemci denetimini, bileşenini veya davranışını temsil eden istemci nesnesini desteklemek için işlenmesi gereken örnek betiklerini döndürmek için bir sınıfa geri çağırır. |
| RegisterScriptDescriptors(IScriptControl) |
bir ScriptControl istemci denetimini, bileşenini veya davranışını temsil eden istemci nesnesini desteklemek için işlenmesi gereken örnek betiklerini döndürmek için sınıfı çağırır. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
denetimi kullanarak içindeki bir denetim UpdatePanel için başlangıç betiği bloğu kaydeder ScriptManager ve betik bloğunu sayfaya ekler. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Denetime ScriptManager her zaman uyumsuz geri gönderme için bir başlangıç betiği bloğu kaydeder ve betik bloğunu sayfaya ekler. |
| RemovedControl(Control) |
Nesne koleksiyonundan Controls bir alt denetim kaldırıldıktan sonra çağrılır Control . (Devralındığı yer: Control) |
| Render(HtmlTextWriter) |
ScriptManager Belirtilen HtmlTextWriter nesneyi kullanarak denetimin içeriğini tarayıcıya işler. |
| RenderChildren(HtmlTextWriter) |
Sunucu denetiminin alt öğelerinin içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir. (Devralındığı yer: Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye gönderir. (Devralındığı yer: Control) |
| RenderControl(HtmlTextWriter) |
Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye gönderir ve izleme etkinse denetimle ilgili izleme bilgilerini depolar. (Devralındığı yer: Control) |
| 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 url'ye dönüştürür. (Devralındığı yer: Control) |
| SaveControlState() |
Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder. (Devralındığı yer: Control) |
| SaveViewState() |
Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetimi görünüm durumu değişikliklerini kaydeder. (Devralındığı yer: Control) |
| SetDesignModeState(IDictionary) |
Denetim için tasarım zamanı verilerini ayarlar. (Devralındığı yer: Control) |
| SetFocus(Control) |
Tarayıcı odağını belirtilen denetime ayarlar. |
| SetFocus(String) |
Tarayıcı odağını kimlik tarafından belirtilen denetime ayarlar. |
| 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, 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) |
| 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) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
| TrackViewState() |
Sunucu denetiminin nesnesinde depolanabilmeleri için, sunucu denetiminde StateBag görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye özelliği aracılığıyla ViewState erişilebilir. (Devralındığı yer: Control) |
Ekinlikler
| Name | Description |
|---|---|
| AsyncPostBackError |
Zaman uyumsuz geri gönderme sırasında bir sayfa hatası olduğunda oluşur. |
| 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) |
| Navigate |
Kullanıcı tarayıcının Geri veya İlet düğmesine tıkladığında gerçekleşir. |
| PreRender |
Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir. (Devralındığı yer: Control) |
| ResolveCompositeScriptReference |
Bileşik betik denetime ScriptManager kaydedildiğinde gerçekleşir. |
| ResolveScriptReference |
Koleksiyonun Scripts bir üyesi denetime ScriptManager kaydedildiğinde gerçekleşir. |
| Unload |
Sunucu denetimi bellekten kaldırıldığında gerçekleşir. (Devralındığı yer: Control) |
Belirtik Arabirim Kullanımları
Uzantı Metotları
| Name | Description |
|---|---|
| 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 meta tablo nesnesini döndürür. |
