ClientScriptManager.GetWebResourceUrl(Type, String) Metode

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan referensi URL ke sumber daya dalam rakitan.

public:
 System::String ^ GetWebResourceUrl(Type ^ type, System::String ^ resourceName);

public string GetWebResourceUrl (Type type, string resourceName);

member this.GetWebResourceUrl : Type * string -> string

Public Function GetWebResourceUrl (type As Type, resourceName As String) As String

Parameter

type: Type

Jenis sumber daya.

resourceName: String

Nama sumber daya yang sepenuhnya memenuhi syarat dalam perakitan.

Mengembalikan

String

Referensi URL ke sumber daya.

Pengecualian

ArgumentNullException

Jenis sumber daya web adalah null.

-atau-

Nama sumber daya web adalah null.

-atau-

Nama sumber daya web memiliki panjang nol.

Contoh

Contoh kode berikut menunjukkan penggunaan GetWebResourceUrl metode . Parameter jenis dalam contoh ini diatur ke jenis kelas di rakitan yang berisi sumber daya. Parameter resourceName ditentukan dengan jalur yang sepenuhnya memenuhi syarat ke sumber daya, yang mencakup namespace default.

<%@ 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>

Contoh kode berikut menunjukkan cara menerapkan WebResourceAttribute atribut metadata secara terprogram untuk menandai perakitan untuk sumber daya yang akan dilayani. Kompilasi kelas berikut di pustaka kelas dengan namespace default yang diatur ke Samples.AspNet.CS.Controls atau Samples.AspNet.VB.Controls, tergantung pada bahasa apa yang Anda gunakan.

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

Contoh ini memerlukan file JavaScript bernama Script_include.js. File .js adalah sumber daya yang disematkan di assembly yang berisi ClientScriptResourceLabel objek . Jika Anda menggunakan Visual Studio, di jendela Properti proyek pustaka kelas, atur Tindakan Build ke Sumber Daya Tersemat saat file skrip dipilih. Jika Anda mengkompilasi pustaka di baris perintah, gunakan sakelar /resource untuk menyematkan sumber daya.

function DoClick() {Form1.Message.value='Text from resource script.'}

Keterangan

Metode mengembalikan GetWebResourceUrl referensi URL ke sumber daya yang disematkan dalam rakitan. Referensi yang dikembalikan tidak dikodekan URL. Sumber daya dapat berupa file skrip, gambar, atau file statis apa pun. Anda menentukan jenis berdasarkan objek yang akan mengakses sumber daya.

Sumber daya Web yang terdaftar di halaman diidentifikasi secara unik berdasarkan jenis dan namanya. Hanya satu sumber daya dengan jenis dan pasangan nama tertentu yang dapat didaftarkan ke halaman. Mencoba mendaftarkan sumber daya yang sudah terdaftar tidak membuat duplikat sumber daya terdaftar.

Metode GetWebResourceUrl ini digunakan bersama dengan RegisterClientScriptResource metode untuk mengakses sumber daya yang disematkan dalam rakitan. Untuk informasi selengkapnya tentang menggunakan sumber daya dalam aplikasi, lihat Gambaran Umum Sumber Daya Halaman Web ASP.NET.

Berlaku untuk

Bagikan melalui