ClientScriptManager.RegisterClientScriptInclude Yöntem
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.
İstemci betiğinin dahil olduğu Page nesnesini kaydeder.
Aşırı Yüklemeler
RegisterClientScriptInclude(String, String) |
İstemci betiğini Page , istemciden çağrılmayı sağlayan bir anahtar ve URL kullanarak nesnesine kaydeder. |
RegisterClientScriptInclude(Type, String, String) |
Bir tür, anahtar ve URL kullanarak istemci betiğini nesnesiyle birlikte Page kaydeder. |
RegisterClientScriptInclude(String, String)
İstemci betiğini Page , istemciden çağrılmayı sağlayan bir anahtar ve URL kullanarak nesnesine kaydeder.
public:
void RegisterClientScriptInclude(System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude (string key, string url);
member this.RegisterClientScriptInclude : string * string -> unit
Public Sub RegisterClientScriptInclude (key As String, url As String)
Parametreler
- key
- String
İstemci betiğinin anahtarı kaydolmayı içerir.
- url
- String
İstemci betiğinin URL'si kaydolmayı içerir.
Örnekler
Söz dizimi, kullanım ve bir örnek de dahil olmak üzere ilgili bilgiler için bkz RegisterClientScriptInclude. .
Açıklamalar
İstemci betiği, anahtarı ve türüyle benzersiz bir şekilde tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Belirli bir türe ve anahtar çifte sahip yalnızca bir betik sayfaya kaydedilebilir. Zaten kaydedilmiş bir betiği kaydetmeye çalışmak, betiğin bir kopyasını oluşturmaz.
Bir istemci betiğinin IsClientScriptIncludeRegistered belirli bir anahtarla birlikte eklenip eklenmediğini ve tür çiftinin zaten kayıtlı olup olmadığını belirlemek için yöntemini çağırın ve gereksiz yere betiği eklemeye çalışmaktan kaçının.
Not
İstemci URL'sini çözümlemek için yöntemini kullanın ResolveClientUrl . Bu yöntem, yolu çözümlemek için çağrıldığı URL bağlamını kullanır.
Yönteminin RegisterClientScriptInclude bu aşırı yüklemesi , URL
ve type
parametresini alan key
aşırı yüklemeyi çağırır.
yöntemi, işlenen sayfanın en üstüne bir betik bloğu ekler.
Ayrıca bkz.
Şunlara uygulanır
RegisterClientScriptInclude(Type, String, String)
Bir tür, anahtar ve URL kullanarak istemci betiğini nesnesiyle birlikte Page kaydeder.
public:
void RegisterClientScriptInclude(Type ^ type, System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude (Type type, string key, string url);
member this.RegisterClientScriptInclude : Type * string * string -> unit
Public Sub RegisterClientScriptInclude (type As Type, key As String, url As String)
Parametreler
- type
- Type
İstemci betiğinin türü, kaydolmayı içerir.
- key
- String
İstemci betiğinin anahtarı kaydolmayı içerir.
- url
- String
İstemci betiğinin URL'si kaydolmayı içerir.
Özel durumlar
İstemci betiği ekleme türü: null
.
Örnekler
Aşağıdaki kod örneği yönteminin RegisterClientScriptInclude kullanımını gösterir. Mevcut istemci betiğini denetleme mantığı kaldırılırsa, yöntem yinelenenleri denetlediğinden RegisterClientScriptInclude işlenen sayfada yine de yinelenen istemci betikleri olmayacağını unutmayın. Denetlemenin avantajı, gereksiz hesaplamaları azaltmaktır.
<%@ 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">
public void Page_Load(Object sender, EventArgs e)
{
// Define the name, type and url of the client script on the page.
String csname = "ButtonClickScript";
String csurl = "~/script_include.js";
Type cstype = this.GetType();
// Get a ClientScriptManager reference from the Page class.
ClientScriptManager cs = Page.ClientScript;
// Check to see if the include script exists already.
if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
{
cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<input type="text"
id="Message"/>
<input type="button"
value="ClickMe"
onclick="DoClick()"/>
</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 Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Define the name, type and url of the client script on the page.
Dim csname As String = "ButtonClickScript"
Dim csurl As String = "~/script_include.js"
Dim cstype As Type = Me.GetType()
' Get a ClientScriptManager reference from the Page class.
Dim cs As ClientScriptManager = Page.ClientScript
' Check to see if the include script is already registered.
If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<input type="text"
id="Message"/>
<input type="button"
value="ClickMe"
onclick="DoClick()"/>
</div>
</form>
</body>
</html>
Bu örnekte aşağıdaki içeriklere sahip Script_include.js adlı bir JavaScript dosyası gerekir:
function DoClick() {Form1.Message.value='Text from include script.'}
Açıklamalar
Yöntemin RegisterClientScriptInclude bu aşırı yüklemesi, betiği tanımlamak için anahtar ve URL parametrelerinin yanı sıra istemci betiğinin tanımlanmasını belirten bir type
parametre alır. Türü kaynağa erişecek nesneye göre belirtirsiniz. Örneğin, kaynağa erişmek için bir Page
örnek kullanırken türünü belirtirsiniz Page
.
Not
İstemci URL'sini çözümlemek için yöntemini kullanın ResolveClientUrl . Bu yöntem, yolu çözümlemek için çağrıldığı URL bağlamını kullanır.
Bu yöntem, işlenen sayfanın en üstüne bir betik bloğu ekler.