Referência Rápida ASP

Referência rápida ASP do CodeW3C.com. Imprima, coloque no bolso e use sempre que necessário.

Sintaxe básica

O script ASP é envolvido por <% e %> .Desta forma, o conteúdo é enviado para o navegador:

<html>
<body>
<% response.write("Hello World!") %>
</body>
</html>

The default language in ASP is VBScript. If you need to use another scripting language, insert a language declaration at the top of the ASP page:

<%@ language="javascript" %>
<html>
<body>
<%
....
%>

Forms and user input

Request.QueryString is used to collect values from a form with method="get". Information sent through GET from the form is visible to everyone (it will be displayed in the browser's address bar), and there is also a limit to the amount of data sent.

Request.Form is used to collect values from a form with method="post". Information sent through POST from the form is not visible to others and there is no limit to the amount of data sent.

Cookies ASP

Cookies are commonly used to identify users. Cookies are small files embedded by the server on the user's computer. Every time the same computer requests a page through the browser, the cookie is also sent.

The Response.Cookies command is used to create cookies:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2012"
%>

Note: The Response.Cookies command must be placed before the <html> tag!

The "Request.Cookies" command is used to retrieve cookie values:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Referenced file

With the #include directive, you can insert the content of one ASP file into another before the server executes it. The #include directive is used to create functions, headers, footers, or elements used repeatedly on multiple pages.

Sintaxe:

<!--#include virtual="somefile.inc"-->

or

<!--#include file ="somefile.inc"-->

Use a keyword virtual to indicate a path starting with a virtual directory. If a file named "header.inc" is located in a virtual directory named /html, the following code will insert the content of "header.inc":

<!-- #include virtual ="/html/header.inc" -->

Use a palavra-chave file para indicar caminhos relativos. O caminho relativo começa com o diretório que contém o arquivo de referência. Se seu arquivo estiver no diretório html e o arquivo "header.inc" estiver em html\headers, o código abaixo inserirá o conteúdo do "header.inc":

<!-- #include file ="headers\header.inc" -->

Use a palavra-chave file e a sintaxe (..\) para referenciar arquivos em diretórios de nível superior.

Global.asa

O arquivo Global.asa é um arquivo opcional e pode conter declarações de objetos, variáveis e métodos que podem ser acessados por todas as páginas do aplicativo ASP.

Anotação: O arquivo Global.asa deve estar localizado na raiz do aplicativo ASP e cada aplicativo pode ter apenas um arquivo Global.asa.

O arquivo Global.asa pode conter apenas o seguinte conteúdo:

  • Eventos Application
  • Eventos Session
  • Declaração <object>
  • Declaração da TypeLibrary
  • Instrução #include

Eventos Application e Session

No Global.asa, você pode informar o que fazer com os objetos application e session quando eles começarem e quando terminarem. O código para essa tarefa está no manipulador de eventos.

Anotação: Quando inserirmos código no arquivo Global.asa, não usamos <% e %>, devemos colocar os subprogramas dentro do tag <script> HTML:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' some code
end sub
sub Application_OnEnd
  ' some code
end sub
sub Session_OnStart
  ' some code
end sub
sub Session_OnEnd
  ' some code
end sub
</script>

Declaração <object>

Também é possível criar objetos com escopo session ou application usando a tag <object> no Global.asa.

Anotação: O tag <object> deve estar fora do tag <script>!

Sintaxe:

<object runat="server" scope="scope" id="id">
{progid="progID"|classid="classID"}>
......
</object>

Declaração da TypeLibrary

A TypeLibrary é um contêiner de conteúdo do arquivo DLL correspondente ao objeto COM. Ao incluir chamadas para a TypeLibrary no arquivo Global.asa, é possível acessar os constantes dos objetos COM, enquanto o código ASP também pode reportar erros de maneira mais eficiente. Se o seu aplicativo web depende de objetos COM que já declararam tipos de dados em uma biblioteca de tipos, você pode declarar essa biblioteca de tipos no Global.asa.

Sintaxe:

<!--
METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->

Objeto Session

O objeto Session é usado para armazenar informações sobre a session do usuário ou alterar suas configurações. As variáveis armazenadas no objeto Session contêm informações sobre um único usuário e podem ser acessadas por todas as páginas de um aplicativo.

Conjunto

  • Contents - Contém todos os itens adicionados à session por meio de comandos de script
  • StaticObjects - Contém todos os objetos adicionados à session usando a tag <object> em HTML
  • Contents.Remove(item/index) - Remover um item do conjunto Contents
  • Contents.RemoveAll() - Remover todos os itens do conjunto Contents

Atributo

  • CodePage - Especificar o conjunto de caracteres usado para exibir conteúdo dinâmico
  • LCID - Definir o identificador de região usado para exibir conteúdo dinâmico
  • SessionID - Retornar o id da session
  • Timeout - Definir ou retornar o tempo de expiração da session

Método

  • Abandonar - Revogar todos os objetos no objeto session.

Objeto Application

Um conjunto de arquivos ASP que funcionam juntos para completar uma tarefa é chamado de aplicativo. O objeto Application no ASP é usado para agrupar esses arquivos. Todos os usuários compartilham um objeto Application. O objeto Application deve conter informações usadas por muitas páginas do aplicativo (por exemplo, informações de conexão ao banco de dados).

Conjunto

  • Conteúdo - Contém todos os itens adicionados ao aplicativo por meio de comandos de script.
  • StaticObjects - Contém todos os objetos adicionados à aplicação usando a tag <object> do HTML
  • Contents.Remove - Remove um item da coleção Contents
  • Contents.RemoveAll - Remove todos os itens da coleção Contents

Método

  • Lock - Impede que o usuário modifique as variáveis do objeto Application
  • Unlock - Permite que o usuário modifique as variáveis do objeto Application

Objeto Response

O objeto Response é usado para enviar dados do servidor para o usuário

Conjunto

Cookies(name) - Define o valor do cookie. Se não existir, cria um cookie e define o valor especificado

Atributo

  • Buffer - Determina se a saída deve ser armazenada em buffer. Quando a saída é configurada para buffer, o servidor bloqueia a resposta ao navegador até que todos os scripts de servidor sejam processados, ou até que o script chame o método Flush ou End. Se você deseja definir essa propriedade, ela deve estar localizada antes da tag <html> no arquivo .asp
  • CacheControl - Define se o servidor proxy pode armazenar em cache a saída gerada pelo ASP. Se definido como Public, o servidor proxy armazenará a página em cache
  • Charset(charset_name) - Adicionar o nome do conjunto de caracteres ao cabeçalho content-type do objeto de resposta
  • ContentType - Define o tipo de conteúdo HTTP do objeto de resposta. Por exemplo, "text/html", "image/gif", "image/jpeg", "text/plain". O padrão é "text/html"
  • Expires - Define o tempo de cache da página no navegador antes de expirar (minutos)
  • ExpiresAbsolute - Define a data e hora de expiração da cache da página no navegador
  • IsClientConnected - Indica se o cliente já se desconectou do servidor
  • Pics(pics_label) - Adicionar valor ao sinal de PICS no cabeçalho de resposta
  • Status - Determina o valor da linha de status retornada pelo servidor

Método

  • AddHeader(name, value) - Adicionar novos cabeçalhos HTTP e valores na resposta HTTP
  • AppendToLog string - Adicionar string ao final do registro do servidor (entrada de log do servidor)
  • BinaryWrite(data_to_write) - Escrever dados diretamente na saída sem conversão de caracteres
  • Clear - Limpar a saída cacheada. Use este método para lidar com erros. Se Response.Buffer não for definido como true, o método gerará um erro de tempo de execução
  • End - Parar de processar o script e retornar o resultado atual
  • Flush - Enviar imediatamente a saída cacheada. Se Response.Buffer não for definido como true, o método gerará um erro de tempo de execução
  • Redirect(url) - Redirecionar o usuário para outro URL
  • Write(data_to_write) - Escrever texto para o usuário

Objeto Request

Quando o navegador solicita uma página do servidor, isso é chamado de request. O objeto request é usado para obter informações do usuário.

Conjunto

  • ClientCertificate - Contém os valores dos campos armazenados no certificado do cliente
  • Cookies(name) - Contém os valores do cookie
  • Form(element_name) - Contém os valores do formulário. O formulário deve usar o método POST
  • QueryString(variable_name) - Contém os valores das variáveis na string de consulta
  • ServerVariables(server_variable) - Contém o valor da variável de servidor

Atributo

  • TotalBytes - Retornar o número total de bytes enviados pelo cliente no corpo da solicitação

Método

  • BinaryRead - Retornar os dados enviados do cliente para o servidor como parte de uma solicitação POST

Objeto Server

O objeto Server é usado para acessar atributos e métodos no servidor.

Atributo

ScriptTimeout - Definir ou retornar o tempo que um script pode executar antes de ser encerrado.

Método

  • CreateObject(type_of_object) - Criar uma instância do objeto
  • Execute(caminho) - Executar outro arquivo ASP dentro do arquivo ASP. Após a execução do arquivo chamado, o controle de volta ao arquivo ASP original
  • ) - Retornar o objeto ASPError que descreve o erro ocorrido
  • HTMLEncode(string) - Aplicar codificação HTML a uma string
  • MapPath(caminho) - Mapear um caminho relativo ou virtual para um caminho físico
  • Transfer(caminho) - Enviar todas as informações de estado para outro arquivo, para serem processadas. Após a transmissão, o controle do programa não retornará ao arquivo ASP original
  • URLEncode(string) - Aplicar as regras de codificação URL a strings

Fonte: http://www.codew3c.com/asp/asp_quickref.asp