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 ScriptManager yönelik farklı senaryolar gösterilir.
Partial-Page Güncelleştirmeler etkinleştirme
Aşağıdaki örnekte, kısmi sayfa güncelleştirmelerini etkinleştirmek için denetimin nasıl kullanılacağı ScriptManager gösterilmektedir. Bu örnekte, ve Calendar denetimi bir DropDownList denetimin içindedir UpdatePanel . Varsayılan olarak, özelliğin UpdateMode değeri şeklindedir Alwaysve özelliğin ChildrenAsTriggers değeri de şeklindedir true. Bu nedenle, panelin alt denetimleri zaman uyumsuz bir 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 örnekte, kısmi sayfa güncelleştirmeleri sırasında özel hata işlemenin nasıl sağ gerektiği gösterilmektedir. 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 örnekte, 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ğı gösterilmektedir. Özelliğini, 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 ui 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:
Giriş
Denetim ScriptManager , ASP.NET'da Ajax işlevselliğinin merkezidir. 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 kaydederek istemci betiğinden ASP.NET kimlik doğrulaması, rol ve profil uygulama hizmetlerine ScriptManager erişim sağlayın.
Tarayıcıda ECMAScript (JavaScript) Tarih, Sayı ve Dize işlevlerinin kültüre özgü görünümünü etkinleştirin.
Denetimin özelliğini kullanarak ekli betik dosyaları veya tek başına betik dosyaları için yerelleştirme kaynaklarına ResourceUICultures 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.
Kısmi Sayfa İşleme
Bir ASP.NET sayfasının kısmi sayfa işlemeyi destekleme özelliği aşağıdaki faktörler tarafından denetlener:
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ğin 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ştirilmiş olması gereken bölgelerini yeniler. Kısmi sayfa işleme hakkında daha fazla bilgi için bkz. Kısmi Sayfa İş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 yerleştirilmiş 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.
Komut Dosyası 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ı Komut Dosyasını 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. |
Kısmi Sayfa Güncelleştirme ile Uyumlu Komut Dosyalarını 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. Betiği bir UpdatePanel denetimin içinde kullanmak üzere işliyiyorsanız, 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 ad/değer öznitelik çiftini (bir expando) işler. |
| RegisterHiddenField | Gizli bir alanı işler. |
| RegisterOnSubmitStatement | Öğenin submit olayına form yanıt olarak yürütülen bir betiği kaydeder. onSubmit özniteliği belirtilen 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, bir betiği zaten var olan bir tür/kaynak adı çifti ile 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 İçin Kayıt Yöntemleri
Denetimleri kullanırken kısmi sayfa güncelleştirmelerini özelleştirmek için aşağıdaki yöntemleri kullanabilirsiniz UpdatePanel .
| 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 | Denetimin içindeki UpdatePanel bir 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 denetim 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.
Betikte 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 (Yerelleştirme)
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 UI kültürünü (varsa) kullanarak yapar.
Tek başına betik dosyaları. Denetimi, 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-MX olarak ayarlandıysa, denetim dosya varsa .en-MX.debug.js gibi
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 tetikler. Sunucudaki hataların istemciye gönderilme şekli, Web.config dosyasının özelliğineAsyncPostBackErrorMessage, özelliğine 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.
Tanımlayıcı Sözdizimi
<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
| ScriptManager() |
ScriptManager sınıfının yeni bir örneğini başlatır. |
Özellikler
| 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 bir 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 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 |
Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır. (Devralındığı yer: Control) |
| 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) |
| 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 belirten bir değer alır veya ayarlar. |
| EnablePageMethods |
bir ASP.NET sayfasındaki genel statik sayfa yöntemlerinin istemci betiğinden çağrılıp çağrılamayacağını belirten bir değer alır veya ayarlar. |
| EnablePartialRendering |
Sayfanın kısmi işlenmesini sağlayan bir değeri 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 özgü bilgilerin ayrıştırma ve biçimlendirmesini destekleyen betiği işleyip işlemediğini ScriptManager 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 belirten bir değer alır veya ayarlar. |
| EnableSecureHistoryState |
Geçmiş durum dizesinin şifrelenip şifrelemeyeceğini belirten bir değer alır veya ayarlar. |
| EnableTheming |
Temaların bu denetime uygulanıp uygulanmayacağı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 okunur durumdadır. (Devralındığı yer: Control) |
| HasChildViewState |
Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını belirten 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 denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten 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 belirten 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 belirten 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) |
| LoadScriptsBeforeUI |
Sayfa kullanıcı arabirimi için işaretleme öncesinde veya sonrasında betiklerin yüklenip yüklenmediğini belirten 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ı 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) |
| 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) |
| 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 nesnesi alır. |
| Services |
ServiceReferenceCollection ASP.NET Ajax işlevselliği için istemcide kullanıma sunan her Web hizmeti için bir nesne içeren bir ServiceReference nesnesi 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 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 |
Bu değerin ayarlanmasını Visible önlemek için temel Control sınıftan devralınan özelliği geçersiz kılar. |
Yöntemler
| 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 veri 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) |
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. |
| 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. |
| AddParsedSubObject(Object) |
Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını 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ı izlemesini başlatır. (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 Trace eder. (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, 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 çağrı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() |
Sunucu denetiminin bellekten çıkmadan ö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 |
| Focus() |
Giriş odağını 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 nesnesine 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 nesnesine 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 çiftlerini içeren bir dize alır. |
| 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 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 bir 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) |
Mutlak veya göreli bir sanal yolun eşlendiğini fiziksel yolu alır. (Devralındığı yer: Control) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Olayı tetikler AsyncPostBackError . |
| OnBubbleEvent(Object, EventArgs) |
Sunucu denetimi olayının sayfanın kullanıcı arabirimi 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ı tetikler 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ı oluşturur 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 ScriptManager yönetilen her betik başvurusu için olayı tetiklerResolveScriptReference. |
| 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ı tetikler. |
| RegisterArrayDeclaration(Control, String, String) |
EcMAScript (JavaScript) dizi bildirimini, denetimin ScriptManager içindeki UpdatePanel bir denetimle kullanım denetimiyle kaydeder ve diziyi sayfaya ekler. |
| RegisterArrayDeclaration(Page, String, String) |
EcMAScript (JavaScript) dizi bildirimini, denetimin ScriptManager içindeki UpdatePanel bir denetimle kullanım denetimiyle 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) |
Denetimin içindeki bir denetimle kullanmak üzere denetimiyle ScriptManager bir UpdatePanel istemci betik bloğu kaydeder ve ardından betik bloğunu sayfaya ekler. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Denetimin içindeki bir denetimle kullanmak üzere denetimiyle ScriptManager 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 denetimine bir UpdatePanel istemci betik dosyası kaydeder ve ardından 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 kullanım denetimiyle ScriptManager bir derlemeye eklenmiş 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) |
Kısmi sayfa işleme sırasında bir denetime özel veri gönderir. |
| 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. |
| 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 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 kullanım denetimiyle ScriptManager 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 kullanım denetimiyle ScriptManager birlikte bir derlemeye eklenmiş olan kaynak adına göre kaydeder. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
ECMAScript (JavaScript) kodunu ScriptManager , form gönderildiğinde yürütülen bir denetimle birlikte kullanılan bir UpdatePanel denetimin denetimine kaydeder. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
ECMAScript (JavaScript) kodunu ScriptManager , form gönderildiğinde yürütülen bir denetimle birlikte kullanılan bir UpdatePanel denetimin denetimine 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) |
İstemci ExtenderControl 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) |
İstemci ScriptControl denetimini, bileşenini veya davranışını temsil eden istemci nesnesini desteklemek için işlenmesi gereken örnek betikleri döndürmek için sınıfı çağırır. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
denetimi kullanarak içindeki UpdatePanel bir denetim için başlangıç betiği bloğu kaydeder ScriptManager ve betik bloğunu sayfaya ekler. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Denetimle 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) |
Bir alt denetim nesne koleksiyonundan Controls 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 sağlanan HtmlTextWriter bir nesneye aktarır ve istemcide işlenecek içeriği yazar. (Devralındığı yer: Control) |
| 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 sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır. (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 bir URL'ye dönüştürür. (Devralındığı yer: Control) |
| SaveControlState() |
Sayfa sunucuya geri gönderildiğinden bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder. (Devralındığı yer: Control) |
| SaveViewState() |
Sayfa sunucuya geri gönderildiğinden 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) |
İzleme veri anahtarını ve izleme veri 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 veri 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() |
Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu StateBag denetiminde görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye özelliği üzerinden ViewState erişilebilir. (Devralındığı yer: Control) |
Ekinlikler
| 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 bir sayfa 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. 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 İleri 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 bir üyesi denetime ScriptsScriptManager 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ı
| 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. |
Ş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