ScriptManager Sınıf

Tanım

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 IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Devralma
ScriptManager
Ö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 DropDownList denetimin içindedir UpdatePanel . Varsayılan olarak, özelliğinin UpdateMode değeri , Alwaysözelliğinin ChildrenAsTriggers değeri ise ş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>

Güncelleştirme Hatalarını Partial-Page İş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ğ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 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 merkezinde yer alır. 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 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ü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.

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 denetlenilir:

Sayfanın Init olayı sırasında veya öncesinde çalışma zamanında özelliğin EnablePartialRendering değerini 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ştirilmek zorunda olan 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 sayfa zaten bir ScriptManager denetime sahip 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.

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 korunmasını 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 bağımlılıkların korunmasını 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. Bir denetimin içinde UpdatePanel 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 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 bir 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çmesi gereken 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

Url'yi boş bir Web sayfasına alır veya ayarlar.

EnableCdn

Geçerli sayfanın CDN (Content Delivery Network) yollarından istemci betiği 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ılabileceğini 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 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 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şaretlemeden önce veya sonra 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

Nesne ScriptResourceMapping 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 Ajax işlevselliği için istemcide kullanıma ASP.NET 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 olarak nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
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 Visible ayarlanmasını ö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 nullayarlar.

(Devralındığı yer: Control)
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 id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde pathOffset belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da aramaya yardımcı olur. Yönteminin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
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ş olan ECMAScript (JavaScript) dizi bildirimlerinden oluşan salt okunur bir koleksiyonu alır.

GetRegisteredClientScriptBlocks()

Daha önce denetime ScriptManager kaydedilmiş istemci betik bloklarından oluşan salt okunur bir koleksiyonu alır.

GetRegisteredDisposeScripts()

Daha önce nesnesine Page kaydedilmiş olan betiklerin dispose salt okunur bir koleksiyonunu alır.

GetRegisteredExpandoAttributes()

Daha önce nesnesine Page kaydedilmiş özel (expando) özniteliklerin salt okunur koleksiyonunu alır.

GetRegisteredHiddenFields()

Daha önce nesnesine Page kaydedilmiş gizli alanlardan oluşan salt okunur bir koleksiyonu alır.

GetRegisteredOnSubmitStatements()

Daha önce nesnesiyle Page kaydedilmiş deyimlerin salt okunur bir koleksiyonunu onsubmit alır.

GetRegisteredStartupScripts()

Daha önce nesnesine Page kaydedilmiş başlangıç betiklerinden oluşan salt okunur bir koleksiyonu 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)

Init Olayı başlatır ve sayfada yalnızca bir ScriptManager denetimin mevcut 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ı 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 ScriptManager kullanmak üzere denetimine 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 ScriptManager 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 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 için denetimiyle ScriptManager 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)

Kısmi sayfa işleme sırasında bir denetime özel veriler 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 dispose içindeki UpdatePanel denetim için bir betik kaydeder. Denetim güncelleştirildiğinde veya silindiğinde UpdatePanel betik yürütülür.

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 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 denetim 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 üzere 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 ScriptManager içindeki UpdatePanel bir denetim için bir başlangıç betik bloğu kaydeder 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)

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ı kimlikle 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 verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu denetiminde görünüm durumu değişikliklerinin izlenmesine StateBag neden olur. Bu nesneye özelliği aracılığıyla 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 İ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ı

IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Bu üyenin açıklaması için bkz LoadPostData(String, NameValueCollection). .

IPostBackDataHandler.RaisePostDataChangedEvent()

Bu üyenin açıklaması için bkz RaisePostDataChangedEvent(). .

IPostBackEventHandler.RaisePostBackEvent(String)

Denetimin ScriptManager bir geri gönderme olayını işlemesini ve Web sayfasının geçmiş durumunu yüklemesini sağlar.

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.