United States

Change

All Microsoft Sites

Help and Support

ID do artigo: 910442 - Última revisão: segunda-feira, 15 de janeiro de 2007 - Revisão: 1.3

Trabalhando com recursos da Web no ASP.NET 2.0

Exibir Aviso de Isenção de Tradução Automática

Aviso de Isenção de Responsabilidade sobre Conteúdo do KB Aposentado

Exibir os produtos aos quais esse artigo se aplica.

Coluna de voz de suporte do ASP.NET

Trabalhando com recursos da Web no ASP.NET 2.0

para personalizar esta coluna às suas necessidades, deseja convidá-lo para enviar suas idéias sobre tópicos que interessam a você e problemas que você deseja ver abordados nos futuros artigos do Knowledge Base e colunas de voz de suporte. Você pode enviar suas idéias e comentários usando o formulário Ask For It (http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=) . Há também um link para o formulário na parte inferior desta coluna.

Nesta página

Expandir tudo | Recolher tudo

Introdução

Olá! Meu nome é Praveen Yerneni e eu sou um líder técnico trabalham com o grupo de suporte do ASP.NET na Microsoft. Na coluna deste mês, vou discutir recursos da Web e como implementá-los em seu aplicativo.

Se você for um desenvolvedor que trabalha amplamente com controles, talvez este artigo útil no endereçamento alguns dos principais problemas que você pode enfrentar ao desenvolvimento de controles. Anteriormente, no Microsoft ASP.NET 1.1, se você quiser implantar arquivos estáticos, como arquivos .HTML, arquivos .css, arquivos de imagem e arquivos de script usando um controle COM, você tinha que criar um instalador e reunir esses arquivos junto com o controle COM. Embora isso trabalhou, ele apresentado muitos problemas ao implantar o controle. Por exemplo, você pode teve problemas com conflitos de versão, com certificando-se de que os arquivos como imagens foram implantados para o mesmo local ou com arquivos estáticos corrompidos ou excluídos que poderia causar o Falha do controle.

Web recursos no Microsoft ASP.NET 2.0 soluciona esses problemas, permitindo que o desenvolvedor incorporar esses recursos no assembly como .Resources. Para acessar esses recursos estáticos, você pode simplesmente chamar um método no código do controle.

Você pode baixar o código de exemplo deste artigo a partir do Centro de Download da Microsoft.

Os seguintes arquivos estão disponíveis para download partir do Centro de Download da Microsoft:

Recolher esta imagemExpandir esta imagem

Download the ConsumeControl.exe package now. (http://download.microsoft.com/download/a/6/c/a6cb843e-7eda-42fb-ade5-1f77d893c1e3/consumecontrol.exe)

Recolher esta imagemExpandir esta imagem

Download the SimpleControl.exe package now. (http://download.microsoft.com/download/a/6/c/a6cb843e-7eda-42fb-ade5-1f77d893c1e3/simplecontrol.exe)

Para obter mais informações sobre como baixar os arquivos de suporte da Microsoft, clique o número abaixo para ler o artigo na Base de Dados de Conhecimento da Microsoft:

119591 (http://support.microsoft.com/kb/119591/ ) Como obter arquivos de suporte da Microsoft a partir dos serviços online

Microsoft examinou esse arquivo em busca de vírus. Microsoft utilizou o mais recente software de detecção de vírus que estava disponível na data em que o arquivo foi postado. O arquivo é armazenado em servidores de segurança avançada que ajudam a evitar qualquer alteração não autorizada no arquivo.

Voltar para o início

Como funcionam os recursos da Web

Recursos da Web dependem de um manipulador especial que é denominado WebResource.axd, projetado para recuperar os recursos de assembly e Servi-los para o navegador da Web. O tipo de manipulador de WebResource.axd é AssemblyResourceLoader .

Quando chegar uma solicitação do cliente para WebResource.axd, o manipulador de procura para o identificador do recurso da Web no método QueryString do objeto Request . Com base no valor do identificador do recurso da Web, o manipulador, em seguida, tenta carregar o assembly que contém esse recurso. Se essa operação for bem-sucedida, o manipulador será, em seguida, procurar o atributo de assembly e carregar o o fluxo de recursos do conjunto de módulos (assembly). Finalmente, o manipulador será capturar os dados do fluxo de recursos e enviá-lo ao cliente junto com o tipo de conteúdo que você especificar no atributo de assembly.

A URL para WebResource.axd é semelhante ao seguinte:

WebResource.axd?d=SbXSD3uTnhYsK4gMD8fL84_mHPC5jJ7lfdnr1_WtsftZiUOZ6IXYG8QCXW86UizF0&t=632768953157700078

o formato dessa URL é WebResource.axd?d= encrypted identifier & t =time stamp value. "D" significa para o recurso da Web solicitado. O "t" é o carimbo de data / hora para o assembly solicitado, que pode ajudar a determinar se houve quaisquer alterações para o recurso.

Voltar para o início

Delving no código

No meu exemplo, eu desenvolveram um controle COM que é consumido por um aplicativo da Web do ASP.NET para demonstrar esse novo recurso.

Controle de COM para o recurso da Web

Para criar e incorporar um recurso da Web, desenvolveram uma COM controle ( SimpleControl ). Ele tem os seguintes recursos incorporados:

Dois arquivos que são nomeados smallFail.gif e smallSuccess.gif de imagem. Esses arquivos de imagem são usados para efeitos de sobreposição no controle e são consumidos dentro do código de controle.
Um arquivo HTML que é denominado Help.htm. Este arquivo não contém a quantidade de texto e é apenas para demonstração.
Um arquivo JavaScript que é denominado MyScript.js. Este arquivo contém um código JavaScript que também demonstra o recurso de substituição para obter uma referência a outro recurso incorporado dentro do mesmo assembly.
Um arquivo .CSS que é denominado MyStyleSheet.css. Esta folha de estilos, em seguida, é consumida diretamente do aplicativo da Web do ASP.NET.

Neste artigo, discutirei as partes que são necessárias para recursos da Web.

Incorporar os recursos da Web

Primeiro, você precisará verificar se todos os arquivos estáticos que são adicionados ao projeto Web Control Library no Microsoft Visual Studio 2005 são recursos incorporados. Para incorporar esses recursos, tudo o que você precisa fazer é adicionar esses arquivos ao Visual Studio e, em seguida, modificar as propriedades desses arquivos para que a ação de compilação é definida como Embedded Resource de ferramentas de laboratório.

Após você ter feito isso, você também precisará criar-se que esses recursos têm sido referenciados pelo atributo WebResource assembly no arquivo AssemblyInfo.cs como mostrado abaixo.

[assembly: WebResource("SimpleControl.Help.htm", "text/html")]
[assembly: WebResource("SimpleControl.MyStyleSheet.css", "text/css")]
[assembly: WebResource("SimpleControl.smallFail.gif", "image/gif")]
[assembly: WebResource("SimpleControl.smallSuccess.gif", "image/gif")]
[assembly: WebResource("SimpleControl.MyScript.js", "text/javascript", PerformSubstitution = true)]

O atributo de assembly de WebResource tem três parâmetros da seguinte maneira:

recursos da Web : O nome do recurso que está incorporado no assembly
ContentType : tipo de arquivo A MIME para o recurso
PerformSubstitution : um valor Boolean que determina se outras URLs de recursos da Web mencionados neste recurso são analisados e substituídos com o caminho completo do recurso

Buscando os recursos da Web

Para obter o recurso da Web, eu usei o método GetWebResourceUrl , que é um método para a classe do ClientScriptManager que é normalmente usado para gerenciar scripts no cliente. Esse método retorna uma referência de URL para o recurso do lado do servidor que está incorporado em um assembly. O método GetWebResourceUrl aceita dois parâmetros a seguir:

tipo : O tipo de recurso do servidor
nome do recurso : O nome do recurso do servidor

To use this method, first you have to create an instance of the ClientScriptManager class and get the type of the class as shown below.

ClientScriptManager cs = Page.ClientScript;
            Type rsType = this.GetType();

When you have an instance of this class, you then have to call this method and pass the appropriate parameters as shown below, where I create a HyperLink button, and set the NavigateURL method to point to an embedded HTML resource.

HyperLink hlHelpFile = new HyperLink();
            hlHelpFile.NavigateUrl = cs.GetWebResourceUrl(rsType, "SimpleControl.Help.htm");
            hlHelpFile.Attributes.Add("onmouseover", "ChangeImage('image1','Red')");
            hlHelpFile.Attributes.Add("onmouseout", "RollbackImage('image1','Green')");
            
            this.Controls.Add(hlHelpFile);

            Image imgTest = new Image();
            imgTest.ImageUrl = cs.GetWebResourceUrl(rsType, "SimpleControl.smallFail.gif");
            imgTest.ID = "image1";
            hlHelpFile.Controls.Add(imgTest);

Also in the same code listing above, I have created an Image button and the ImageUrl attribute is getting its value from another embedded .gif image resource.

Usando o recurso de substituição

Outro recurso útil do uso de recursos da Web é a propriedade de PerformSubstitution do atributo WebResource conforme mostrado na seção "incorporação de objetos a recursos da Web" acima. Esse recurso permite que você realmente Obtenha recursos da Web dentro de outro recurso incorporado. Se essa propriedade estiver habilitada, o manipulador de WebResource analisará o recurso incorporado e substitua a sintaxe para o atributo de assembly WebResource por recursos reais antes que atende a página.

No código acima, você irá notar que o controle HyperLink tem um evento de lado do cliente que é denominado ChangeImage . Esta função ChangeImage está localizada em um arquivo de script. A seguir está o código para esse script.

function ChangeImage(imgControl,varcolor){
   document.getElementById(imgControl).src = '<%= WebResource("SimpleControl.smallSuccess.gif")%>';
    document.getElementById('Label1').style.color = varcolor;
}

function RollbackImage(imgControl, varcolor){
   document.getElementById(imgControl).src = '<%= WebResource("SimpleControl.smallFail.gif")%>';
   document.getElementById('Label1').style.color = varcolor;
}

Este arquivo de script chamado MyScript.js é também um recurso incorporado no mesmo controle COM. E observe se ESTOU usando o método WebResource para fazer referência a outro incorporados recurso no arquivo de script.

Também, para verificar se esse arquivo JavaScript está registrado na página, eu usar o RegisterClientScriptInclude método da classe ClientScriptManager como mostrado abaixo.

cs.RegisterClientScriptInclude("MyScript", cs.GetWebResourceUrl(rsType, "SimpleControl.MyScript.js"));

Consumindo o controle no ASP.NET

Depois de você ter criado o controle COM êxito, você precisará usar esse controle em um projeto do ASP.NET de cliente. Para fazer isso, você apenas precise adicionar o controle para caixa de ferramentas no ASP.NET. Em seguida, você pode adicionar o controle a qualquer formulário da Web no designer.

Quando você adiciona o controle para caixa de ferramentas, o controle está registrado para você e o código a seguir é adicionado quando você examinar a sintaxe HTML.

<cc1:MSButton ID="MSButton1" runat="server" strText="Problems?"></cc1:MSButton>

no meu controle COM, também tenha incorporado um arquivo de folha de estilo, que estará usando no meu aplicativo ASP.NET. Para acessar esta folha de estilos, é necessário adicionar um link HtmlControl na página HTML e defina a propriedade runat ao servidor , como mostrado abaixo.

<link rel="Stylesheet"  id="lnkStyle" runat="server"  />

Depois disso, você pode definir programaticamente o atributo de href deste controle para apontar para o atributo de assembly WebResource no evento Page_Load , como mostrado abaixo.

protected void Page_Load(object sender, EventArgs e)
    {
        //Get the name of the Web Resource.
        String rsname = "SimpleControl.MyStyleSheet.css";
        
        //Get the type of the class.
        Type rstype = typeof(SimpleControl.MSButton);

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;
        lnkStyle.Href = cs.GetWebResourceUrl(rstype, rsname);
     }

ClientScriptManager cs = Page.ClientScript; lnkStyle.Href = cs.GetWebResourceUrl (rstype, rsname);} ao executar o código, você verá um controle que parece com o seguinte:

Recolher esta imagemExpandir esta imagem

E o controle do mouse, o controle procurará semelhante ao seguinte:

Recolher esta imagemExpandir esta imagem

Quando você clica neste link, ela levará você à página Ajuda, que é incorporada no arquivo de assembly do controle COM.

Voltar para o início

Conclusão

Recursos da Web é um novo recurso útil no ASP.NET 2.0. Você pode usar esse recurso para sua vantagem se você usá-lo organizadamente. Várias técnicas de armazenamento em cache foram usadas para garantir que os recursos da Web não afetam o desempenho do aplicativo.

No ASP.NET 2.0, WebResource.axd é usado internamente pelo Microsoft .NET Framework para recuperar os recursos incorporados. Por exemplo, o .NET Framework usa WebResource.axd para recuperar o arquivo de script WebUIValidation.js que é usado para controles de validação e recuperar o arquivo de script Menu.js para controles de menu .

Voltar para o início

Referências

Para obter mais informações, visite os seguintes sites:

Método ClientScriptManager.GetWebResourceUrl
http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.clientscriptmanager.getwebresourceurl.aspx (http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.clientscriptmanager.getwebresourceurl.aspx)

Classe WebResourceAttribute
http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.webresourceattribute.aspx (http://msdn2.microsoft.com/en-us/library(d=robot)/system.web.ui.webresourceattribute.aspx)

Vinculados vs. recursos incorporados
http://msdn2.microsoft.com/en-us/library/ht9h2dk8.aspx (http://msdn2.microsoft.com/en-us/library/ht9h2dk8.aspx)

Para obter mais informações sobre recursos da Web, consulte o seguinte blogs por Nikhil Kothari:

O que há System.Web.UI.WebResourceAttribute?
http://www.nikhilk.net/WebResourceAttribute.aspx (http://www.nikhilk.net/WebResourceAttribute.aspx)

Reduzir os ataques de negação de serviço com recursos da Web
http://www.nikhilk.net/WebResourcesDenialOfServiceAttack.aspx (http://www.nikhilk.net/WebResourcesDenialOfServiceAttack.aspx)

Voltar para o início

Como sempre, vontade enviar idéias sobre tópicos desejado abordados no futuro colunas ou no Base de Dados de Conhecimento usando o formulário Ask For It (http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=) .

Voltar para o início

A informação contida neste artigo aplica-se a:

Microsoft ASP.NET 2.0

Voltar para o início

kbmt kbhowto kbasp KB910442 KbMtpt

Voltar para o início

Tradução automática

IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Caso venha a encontrar erros neste artigo e queira colaborar no processo de aperfeiçoamento desta ferramenta, por favor preencha o formulário existente na parte inferior desta página. Obrigado.

Clique aqui para ver a versão em Inglês deste artigo: 910442 (http://support.microsoft.com/kb/910442/en-us/ )

Voltar para o início

Aviso de Isenção de Responsabilidade sobre Conteúdo do KB Aposentado

Este artigo trata de produtos para os quais a Microsoft não mais oferece suporte. Por esta razão, este artigo é oferecido "como está" e não será mais atualizado.

Voltar para o início