ClientScriptManager.GetWebResourceUrl(Type, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe uma referência URL para um recurso numa assembleia.
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 StringParâmetros
- type
- Type
O tipo do recurso.
- resourceName
- String
O nome totalmente qualificado do recurso na assembleia.
Devoluções
A referência URL ao recurso.
Exceções
O tipo de recurso web é null.
-ou-
O nome do recurso web é null.
-ou-
O nome do recurso web tem um comprimento zero.
Exemplos
O exemplo de código seguinte demonstra a utilização do GetWebResourceUrl método. O parâmetro de tipo neste exemplo está definido para o tipo de classe na assembleia que contém o recurso. O resourceName parâmetro é especificado com o caminho totalmente qualificado para o recurso, que inclui o namespace por defeito.
<%@ 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>
O exemplo de código seguinte demonstra como aplicar programaticamente o WebResourceAttribute atributo de metadados para marcar a montagem dos recursos que serão servidos. Compila a seguinte classe numa biblioteca de classes com um namespace predefinido definido como Samples.AspNet.CS.Controls ou Samples.AspNet.VB.Controls, dependendo da linguagem que estás a usar.
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
Este exemplo requer um ficheiro JavaScript chamado Script_include.js. O ficheiro .js é um recurso incorporado na assembly que contém o ClientScriptResourceLabel objeto. Se estiver a usar Visual Studio, na janela Propriedades do projeto da biblioteca de classes, defina Build Action para Embedded Resource quando o ficheiro de script for selecionado. Se estiveres a compilar a biblioteca na linha de comandos, usa o switch /resource para incorporar o recurso.
function DoClick() {Form1.Message.value='Text from resource script.'}
Observações
O GetWebResourceUrl método devolve uma referência URL para um recurso embutido numa assembleia. A referência devolvida não está codificada por URL. Os recursos podem ser ficheiros de script, imagens ou qualquer ficheiro estático. Especificas o tipo com base no objeto que irá aceder ao recurso.
Um recurso Web registado na página é identificado de forma única pelo seu tipo e nome. Apenas um recurso com um dado par de tipo e nome pode ser registado na página. Tentar registar um recurso já registado não cria um duplicado do recurso registado.
O GetWebResourceUrl método é utilizado em conjunto com o RegisterClientScriptResource método para aceder a recursos incorporados em assemblies. Para mais informações sobre a utilização de recursos em aplicações, consulte ASP.NET Web Page Resources Overview.