WebResourceAttribute Klasse

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Definiert das Metadatenattribut, das eine eingebettete Ressource in einer Assembly aktiviert. Diese Klasse kann nicht vererbt werden.

public ref class WebResourceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class WebResourceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type WebResourceAttribute = class
    inherit Attribute

Public NotInheritable Class WebResourceAttribute
Inherits Attribute

Vererbung

Object

Attribute

WebResourceAttribute

Attribute

AttributeUsageAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie das WebResourceAttribute Attribut auf einen Namespace angewendet wird, der ein benutzerdefiniertes Steuerelement definiert. MyCustomControl Das zweite Codebeispiel veranschaulicht die Verwendung der MyCustomControl -Klasse in einer Webseite.

Im folgenden Codebeispiel wird veranschaulicht, wie Das WebResourceAttribute Attribut auf eine benutzerdefinierte Assembly angewendet wird, um eine Bildwebressource und eine HTML-Webressource zu definieren. Die MyCustomControl -Klasse definiert ein zusammengesetztes Steuerelement, das die Ressourcen verwendet, um den Wert der ImageUrl -Eigenschaft eines Image Steuerelements festzulegen, das im zusammengesetzten Steuerelement enthalten ist, und um die HRef -Eigenschaft eines HtmlAnchor Steuerelements festzulegen, das mit der HTML-Ressource verknüpft ist.

using System;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;

[assembly: WebResource("image1.jpg", "image/jpeg")]
[assembly: WebResource("help.htm", "text/html", PerformSubstitution=true)]
namespace Samples.AspNet.CS.Controls
{

    public class MyCustomControl : Control
    {

        [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
        protected override void CreateChildControls()
        {
            
            // Create a new Image control.
            Image _img = new Image();
            _img.ImageUrl = this.Page.ClientScript.GetWebResourceUrl(typeof(MyCustomControl), "image1.jpg");
            this.Controls.Add(_img);

            // Create a new Label control.
            Label _lab = new Label();
            _lab.Text = "A composite control using the WebResourceAttribute class.";
            this.Controls.Add(_lab);

            // Create a new HtmlAnchor control linking to help.htm.
            HtmlAnchor a = new HtmlAnchor();
            a.HRef = this.Page.ClientScript.GetWebResourceUrl(typeof(MyCustomControl), "help.htm");
            a.InnerText = "help link";
            this.Controls.Add(new LiteralControl("<br />"));
            this.Controls.Add(a);
        }
    }
}

Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.HtmlControls
Imports System.Web.UI.WebControls

<Assembly: WebResource("image1.gif", "image/jpeg")> 
<Assembly: WebResource("help.htm", "text/html", PerformSubstitution:=True)> 
Namespace Samples.AspNet.VB.Controls

    Public Class MyCustomControl
        Inherits Control

        <System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
        Protected Overrides Sub CreateChildControls()

            ' Create a new Image control.
            Dim _img As New Image()
            _img.ImageUrl = Me.Page.ClientScript.GetWebResourceUrl(GetType(MyCustomControl), "image1.jpg")
            Me.Controls.Add(_img)

            ' Create a new Label control.
            Dim _lab As New Label()
            _lab.Text = "A composite control using the WebResourceAttribute class."
            Me.Controls.Add(_lab)

            ' Create a new HtmlAnchor control linking to help.htm.
            Dim a As HtmlAnchor = New HtmlAnchor()
            a.HRef = Me.Page.ClientScript.GetWebResourceUrl(GetType(MyCustomControl), "help.htm")
            a.InnerText = "help link"
            Me.Controls.Add(New LiteralControl("<br />"))
            Me.Controls.Add(a)

        End Sub
    End Class

End Namespace

Im folgenden Codebeispiel wird die Verwendung der MyCustomControl -Klasse in einer Webseite veranschaulicht.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="AspNetSamples" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS.Controls" %>
<%@ Import Namespace="System.Reflection" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
            
    // Get the assembly metatdata.
    Type clsType = typeof(MyCustomControl);
    Assembly a = clsType.Assembly;

    // Iterate through the attributes for the assembly.
    foreach (Attribute attr in Attribute.GetCustomAttributes(a))
    {
      //Check for WebResource attributes.
      if (attr.GetType() == typeof(WebResourceAttribute))
      {
        WebResourceAttribute wra = (WebResourceAttribute)attr;
        Response.Write("Resource in the assembly: " + wra.WebResource.ToString() +
          " with ContentType = " + wra.ContentType.ToString() +
          " and PerformsSubstitution = " + wra.PerformSubstitution.ToString() + "</br>");
      }
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>WebResourceAttribute Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <AspNetSamples:MyCustomControl id="MyCustomControl1" runat="server">
      </AspNetSamples:MyCustomControl>    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register TagPrefix="AspNetSamples" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB.Controls" %>
<%@ Import Namespace="System.Reflection" %>

<!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)

    ' Get the assembly metatdata.
    Dim clsType As Type = GetType(MyCustomControl)
    Dim a As Assembly = clsType.Assembly
    
    For Each attr As Attribute In Attribute.GetCustomAttributes(a)
      'Check for WebResource attributes.
      If attr.GetType() Is GetType(WebResourceAttribute) Then
        Dim wra As WebResourceAttribute = CType(attr, WebResourceAttribute)
        Response.Write("Resource in the assembly: " & wra.WebResource.ToString() & _
        " with ContentType = " & wra.ContentType.ToString() & _
        " and PerformsSubstitution = " & wra.PerformSubstitution.ToString() & "</br>")
      End If
    Next attr
    
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>WebResourceAttribute Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <AspNetSamples:MyCustomControl id="MyCustomControl1" runat="server">
      </AspNetSamples:MyCustomControl>    
    </div>
    </form>
</body>
</html>

In diesem Beispiel müssen Sie die Image1.jpg und Help.htm Ressourcen mit der Assembly kompilieren, die enthält MyCustomControl. Weitere Informationen finden Sie unter /resource (C#-Compileroptionen) oder /resource (Visual Basic).

Als Nächstes wird ein Beispiel für eine HTML-Webressource gezeigt, die in diesem Beispiel verwendet werden könnte. Beachten Sie die Verwendung der WebResource Syntax, die verwendet wird, wenn Sie die PerformSubstitution -Eigenschaft für eine Webressource auf true festlegen.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html >

<head>

<title>Included Help Page</title>

</head>

<body>

<div>

<img alt="help image" src=<% = WebResource("image1.jpg") %> />

Included help file.

</div>

</body>

</html>

Hinweise

Die WebResourceAttribute -Klasse ist nur gültig, wenn sie für Assemblydeklarationen verwendet wird. Sie wird verwendet, um eine angegebene eingebettete Ressource in einer Assembly für die Verwendung als Webressource zu aktivieren.

Weitere Informationen zu Ressourcen finden Sie unter Übersicht über ASP.NET-Webseitenressourcen.

Konstruktoren

WebResourceAttribute(String, String)

Initialisiert eine neue Instanz der WebResourceAttribute-Klasse mit der angegebenen Webressource und dem angegebenen Inhaltstyp der Ressource.

Eigenschaften

CdnPath	Ruft den Pfad eines Inhaltszustellungsnetzwerks (CDN) ab, das Webressourcen enthält, oder legt ihn fest.
CdnSupportsSecureConnection	Ruft einen Wert ab, der für den ScriptManager angibt, ob über eine sichere Verbindung zum Inhaltszustellungsnetzwerk (CDN) auf eine Skriptressource zugegriffen werden soll, wenn der Zugriff auf die Seite via HTTPS erfolgt.
ContentType	Ruft eine Zeichenfolge ab, die den MIME-Typ der Ressource enthält, auf die die WebResourceAttribute-Klasse verweist.
LoadSuccessExpression	Ruft einen Ausdruck ab oder legt einen Ausdruck fest, der verwendet wird, wenn eine Webressource erfolgreich geladen wurde.
PerformSubstitution	Ruft einen booleschen Wert ab, der bestimmt, ob während der Verarbeitung der eingebetteten Ressource, auf die die WebResourceAttribute-Klasse verweist, URLs von anderen Webressourcen analysiert und durch den vollständigen Pfad zu der Ressource ersetzt werden, oder legt einen solchen booleschen Wert fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
WebResource	Ruft eine Zeichenfolge ab, die den Namen der Ressource enthält, auf die die WebResourceAttribute-Klasse verweist.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Weitere Informationen

• Attribute
• Übersicht über ASP.NET-Webseitenressourcen
• Ressourcen in Anwendungen
• /resource (Ressourcendatei in Ausgabe einbetten) (C#-Compileroptionen)
• /resource (Visual Basic)
• Verpacken und Bereitstellen von Ressourcen