Page.RegisterClientScriptBlock-Methode
HINWEIS: Diese Methode ist mittlerweile veraltet.
Gibt in der Antwort clientseitige Skriptblöcke aus.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ObsoleteAttribute("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Overridable Sub RegisterClientScriptBlock ( _
key As String, _
script As String _
)
'Usage
Dim instance As Page
Dim key As String
Dim script As String
instance.RegisterClientScriptBlock(key, script)
[ObsoleteAttribute("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202")]
public virtual void RegisterClientScriptBlock (
string key,
string script
)
[ObsoleteAttribute(L"The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202")]
public:
virtual void RegisterClientScriptBlock (
String^ key,
String^ script
)
/** @attribute ObsoleteAttribute("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202") */
public void RegisterClientScriptBlock (
String key,
String script
)
ObsoleteAttribute("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202")
public function RegisterClientScriptBlock (
key : String,
script : String
)
Parameter
- key
Eindeutiger Schlüssel, der einen Skriptblock bezeichnet.
- script
Inhalt des Skripts, das an den Client gesendet wird.
Hinweise
Das Clientskript wird direkt nach dem öffnenden Tag des <form runat= server>-Elements für das Page-Objekt ausgegeben. Sie müssen den im script-Parameter angegebenen Skriptblock in öffnende und schließende <script>-Elemente einschließen.
Da diese Methode einen Schlüssel zum Identifizieren des Skriptblocks verwendet, muss der Skriptblock nicht bei jeder Anforderung durch eine andere Serversteuerelementinstanz an den Ausgabestream ausgegeben werden. Durch die Verwendung eines Schlüssels wird zudem die Wahrscheinlichkeit verringert, dass sich Skriptblocks unterschiedlicher Steuerelemente gegenseitig störend beeinflussen.
Alle Skriptblöcke mit denselben key-Parameterwerten werden als Duplikate betrachtet.
Hinweis
Vergessen Sie nicht, das Skript in HTML-Kommentartags einzuschließen, damit es nicht gerendert wird, wenn ein anfordernder Browser Skripts nicht unterstützt.
Die RegisterClientScriptBlock-Methode ist veraltet. Verwenden Sie stattdessen die RegisterClientScriptBlock-Methode in der ClientScriptManager-Klasse.
Beispiel
Im folgenden Codebeispiel wird die Verwendung der RegisterClientScriptBlock-Methode in Verbindung mit der IsClientScriptBlockRegistered-Methode veranschaulicht. Wenn von IsClientScriptBlockRegistered bestimmt wurde, dass das ECMAScript im Codedeklarationsblock noch nicht registriert wurde, erfolgt ein Aufruf von RegisterClientScriptBlock.
<html>
<head>
<script language="VB" runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
If (Not IsClientScriptBlockRegistered("clientScript")) Then
'Form the script that is to be registered at client side.
Dim scriptString As String = "<script language=JavaScript> function DoClick() {"
scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<"
scriptString += "/"
scriptString += "script>"
RegisterClientScriptBlock("clientScript", scriptString)
End If
End Sub
</script>
</head>
<body topmargin="20" leftmargin="10">
<form id="myForm" runat="server">
<input type="text" id="show" style="width=200">
<input type="button" value="ClickMe" onclick="DoClick()">
</form>
</body>
</html>
<html>
<head>
<script language="C#" runat="server">
public void Page_Load(Object sender, EventArgs e)
{
if (!this.IsClientScriptBlockRegistered("clientScript"))
{
// Form the script that is to be registered at client side.
String scriptString = "<script language=JavaScript> function DoClick() {";
scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<";
scriptString += "/";
scriptString += "script>";
this.RegisterClientScriptBlock("clientScript", scriptString);
}
}
</script>
</head>
<body topmargin="20" leftmargin="10">
<form id="myForm" runat="server">
<input type="text" id="show" style="width=200"> <input type="button" value="ClickMe" onclick="DoClick()">
</form>
</body>
</html>
<html>
<head>
<script language="VJ#" runat="server">
public void Page_Load(Object sender, EventArgs e)
{
if (!(this.IsClientScriptBlockRegistered("clientScript")))
{
// Form the script that is to be registered at client side.
String scriptString =
"<script language=JavaScript> function DoClick() {";
scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<";
scriptString += "/";
scriptString += "script>";
this.RegisterClientScriptBlock("clientScript", scriptString);
}
}//Page_Load
</script>
</head>
<body topmargin="20" leftmargin="10">
<form id="myForm" runat="server">
<input type="text" id="show" style="width=200"> <input type="button" value="ClickMe" onclick="DoClick()">
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0