Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase WebResourceAttribute

 

Publicado: octubre de 2016

Define el atributo de metadatos que habilita un recurso incrustado en un ensamblado. Esta clase no puede heredarse.

Espacio de nombres:   System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Attribute
    System.Web.UI.WebResourceAttribute

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

NombreDescripción
System_CAPS_pubmethodWebResourceAttribute(String, String)

Inicializa una nueva instancia de la WebResourceAttribute clase con el recurso Web especificado y el tipo de contenido de recursos.

NombreDescripción
System_CAPS_pubpropertyCdnPath

Obtiene o establece la ruta de acceso de una red de entrega de contenido (CDN) que contiene recursos Web.

System_CAPS_pubpropertyCdnSupportsSecureConnection

Obtiene o establece un valor que indica a la ScriptManager Si un recurso de script debe obtenerse acceso mediante una conexión segura a la ruta de acceso de entrega de contenido (CDN) de la red cuando se tiene acceso a la página mediante HTTPS.

System_CAPS_pubpropertyContentType

Obtiene una cadena que contiene el tipo MIME del recurso al que hace referencia la WebResourceAttribute clase.

System_CAPS_pubpropertyLoadSuccessExpression

Obtiene o establece una expresión que se utiliza cuando se ha cargado correctamente un recurso Web.

System_CAPS_pubpropertyPerformSubstitution

Obtiene o establece un valor booleano que determina si, durante el procesamiento del recurso incrustado al que hace referencia la WebResourceAttribute clase otro recurso Web direcciones URL se analizan y se reemplaza con la ruta de acceso completa al recurso.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyWebResource

Obtiene una cadena que contiene el nombre del recurso al que hace referencia la WebResourceAttribute clase.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

La WebResourceAttribute clase es válida sólo cuando se utiliza en declaraciones de ensamblado. Se utiliza para habilitar un recurso incrustado especificado en un ensamblado para su uso como un recurso Web.

Para obtener más información sobre recursos, consulte ASP.NET Web Page Resources Overview.

Esta sección contiene dos ejemplos de código. El primer ejemplo de código muestra cómo aplicar el WebResourceAttribute atributo a un espacio de nombres que define un control personalizado, MyCustomControl. El segundo ejemplo de código muestra cómo utilizar el MyCustomControl clase en una página Web.

En el ejemplo de código siguiente se muestra cómo aplicar el WebResourceAttribute atributo en un ensamblado personalizado para definir un recurso Web de imagen y un recurso HTML Web. La MyCustomControl clase define un control compuesto que utiliza los recursos para establecer el valor de la ImageUrl propiedad de un Image control que está contenida dentro del control compuesto y establecer el HRef propiedad de un HtmlAnchor control vincular el recurso HTML.

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

		}
	}

}

En el ejemplo de código siguiente se muestra cómo utilizar el MyCustomControl clase en una página Web.

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

Este ejemplo requiere que se compilen los recursos Image1.jpg y Help.htm con el ensamblado que contiene MyCustomControl. Para obtener más información, consulte, /resource (C# Compiler Options) o /resource (Visual Basic).

Se muestra un ejemplo de un recurso HTML Web que se usa en este ejemplo siguiente. Tenga en cuenta el uso de la WebResource sintaxis, que se utiliza cuando se configura el PerformSubstitution propiedad true de un recurso Web.

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

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

<title>Included Help Page</title>

</head>

<body>

<div>

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

Included help file.

</div>

</body>

</html>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: