ClientScriptManager.GetWebResourceUrl(Type, String) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri egy szerelvény erőforrására mutató URL-hivatkozást.
public:
System::String ^ GetWebResourceUrl(Type ^ type, System::String ^ resourceName);public string GetWebResourceUrl(Type type, string resourceName);member this.GetWebResourceUrl : Type * string -> stringPublic Function GetWebResourceUrl (type As Type, resourceName As String) As StringParaméterek
- type
- Type
Az erőforrás típusa.
- resourceName
- String
Az erőforrás teljes neve a szerelvényben.
Válaszok
Az erőforrásRA mutató URL-hivatkozás.
Kivételek
A webes erőforrás típusa.null
-vagy-
A webes erőforrás neve .null
-vagy-
A webes erőforrás neve nulla hosszúságú.
Példák
Az alábbi példakód a metódus használatát GetWebResourceUrl mutatja be. A példában szereplő típusparaméter az erőforrást tartalmazó szerelvény osztálytípusára van állítva. A resourceName paraméter az erőforrás teljes elérési útjával van megadva, amely tartalmazza az alapértelmezett névteret.
<%@ Page Language="C#"%>
<%@ Import Namespace="Samples.AspNet.CS.Controls" %>
<!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 resource name and type.
String rsname = "Samples.AspNet.CS.Controls.script_include.js";
Type rstype = typeof(ClientScriptResourceLabel);
// Get a ClientScriptManager reference from the Page class.
ClientScriptManager cs = Page.ClientScript;
// Write out the web resource url.
ResourcePath.InnerHtml = cs.GetWebResourceUrl(rstype, rsname);
// Register the client resource with the page.
cs.RegisterClientScriptResource(rstype, rsname);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1"
runat="server">
The web resource path is
<span id="ResourcePath"
runat="server"/>.
<br />
<br />
<input type="text"
id="Message" />
<input type="button"
onclick="DoClick()"
value="ClientClick" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="Samples.AspNet.VB.Controls" %>
<!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 resource name and type.
Dim rsname As String = "Samples.AspNet.VB.Controls.script_include.js"
Dim rstype As Type = GetType(ClientScriptResourceLabel)
' Get a ClientScriptManager reference from the Page class.
Dim cs As ClientScriptManager = Page.ClientScript
' Write out the web resource url.
ResourcePath.InnerHtml = cs.GetWebResourceUrl(rstype, rsname)
' Register the client resource with the page.
cs.RegisterClientScriptResource(rstype, rsname)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1"
runat="server">
The web resource path is
<span id="ResourcePath"
runat="server"/>.
<br />
<br />
<input type="text"
id="Message" />
<input type="button"
onclick="DoClick()"
value="ClientClick" />
</form>
</body>
</html>
Az alábbi példakód bemutatja, hogyan alkalmazhatja programozott módon a WebResourceAttribute metaadat-attribútumot a kiszolgálni kívánt erőforrások szerelvényének megjelölésére. Állítsa össze a következő osztályt egy osztálytárban, amelynek alapértelmezett névtere az ön által használt nyelvtől függően van beállítvaSamples.AspNet.CS.Controls.Samples.AspNet.VB.Controls
using System;
using System.Web;
using System.Web.UI;
using System.Security.Permissions;
[assembly: WebResource("Samples.AspNet.CS.Controls.script_include.js", "application/x-javascript")]
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ClientScriptResourceLabel
{
// Class code goes here.
}
}
Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions
<Assembly: WebResource("Samples.AspNet.VB.Controls.script_include.js", "application/x-javascript")>
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class ClientScriptResourceLabel
' Class code goes here.
End Class
End Namespace
Ehhez a példához egy JavaScript-fájlra Script_include.jsvan szükség. A .js fájl egy beágyazott erőforrás az objektumot tartalmazó ClientScriptResourceLabel szerelvényben. Ha Visual Studio használ, az osztálytár-projekt Tulajdonságok ablak állítsa Build ActionEmbedded Resource értékre a szkriptfájl kiválasztásakor. Ha a parancssorban összeállítja a kódtárat, az /resource kapcsolóval ágyazza be az erőforrást.
function DoClick() {Form1.Message.value='Text from resource script.'}
Megjegyzések
A GetWebResourceUrl metódus egy szerelvénybe ágyazott erőforrásRA mutató URL-hivatkozást ad vissza. A visszaadott hivatkozás nem AZ URL-cím kódolása. Az erőforrások lehetnek szkriptfájlok, képek vagy bármely statikus fájl. Az erőforráshoz hozzáférő objektum alapján adja meg a típust.
A lapon regisztrált webes erőforrásokat a rendszer egyedileg azonosítja a típus és a név alapján. A lapon csak egy adott típusú és névpárt tartalmazó erőforrás regisztrálható. Ha egy már regisztrált erőforrást próbál regisztrálni, az nem hozza létre a regisztrált erőforrás másolatát.
A GetWebResourceUrl metódust a rendszer a RegisterClientScriptResource szerelvényekbe ágyazott erőforrások elérésére szolgáló módszerrel együtt használja. További információ az erőforrások alkalmazásokban való használatáról: ASP.NET weblap erőforrásainak áttekintése.
