Rychlý průvodce ASP
Rychlý průvodce ASP od W3Schools. Vytiskněte si ho a složte do kapsy.
Základní syntaxe
Skripty ASP jsou obklopeny <% a %>. Chcete-li zapsat nějaký výstup do prohlížeče:
<html>
<body>
<% response.write("Ahoj světe!") %>
</body>
</html>
Výchozí jazyk v ASP je VBScript. Chcete-li použít jiný skriptovací jazyk, vložte specifikaci jazyka na začátek stránky ASP:
<%@ language="javascript" %>
<html>
<body>
<%
....
%>
Formuláře a uživatelský vstup
Request.QueryString se používá ke shromažďování hodnot ve formě s method="get". Informace odeslané z formuláře metodou GET jsou viditelné pro všechny (zobrazí se v adresním řádku prohlížeče) a mají omezení na množství informací, které se mají odeslat.
Request.Form se používá ke shromažďování hodnot ve formuláři s method="post". Informace odeslané z formuláře metodou POST jsou pro ostatní neviditelné a nemají žádná omezení na množství informací, které se mají odeslat.
Soubory cookie ASP
K identifikaci uživatele se často používá cookie. Cookie je malý soubor, který server vloží do počítače uživatele. Pokaždé, když stejný počítač požádá o stránku s prohlížečem, odešle také cookie.
Příkaz Response.Cookies se používá k vytváření souborů cookie:
<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2002"
%>
Poznámka: Příkaz Response.Cookies se musí objevit PŘED tagem <html>!
Příkaz „Request.Cookies“ se používá k načtení hodnoty cookie:
<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>
Včetně souborů
Obsah jednoho souboru ASP můžete vložit do jiného souboru ASP dříve, než jej server spustí, pomocí direktivy #include. Direktiva #include se používá k vytvoření funkcí, záhlaví, zápatí nebo prvků, které budou znovu použity na více stránkách
Syntax:
<!--#include virtual="somefile.inc"-->
nebo
<!--#include file ="somefile.inc"-->
Pomocí klíčového slova virtual označte cestu začínající virtuálním adresářem. Pokud se soubor s názvem "header.inc" nachází ve virtuálním adresáři s názvem /html, následující řádek vloží obsah "header.inc":
<!-- #include virtual ="/html/header.inc" -->
K označení relativní cesty použijte klíčové slovo file. Relativní cesta začíná adresářem, který obsahuje soubor včetně. Pokud máte soubor v adresáři html a soubor "header.inc" se nachází v html\headers, následující řádek vloží do vašeho souboru "header.inc":
<!-- #include file ="headers\header.inc" -->
K zahrnutí souboru z adresáře vyšší úrovně použijte klíčové slovo file se syntaxí (..\).
Global.asa
Soubor Global.asa je volitelný soubor, který může obsahovat deklarace objektů, proměnných a metod, ke kterým má přístup každá stránka v aplikaci ASP.
Poznámka: Soubor Global.asa musí být uložen v kořenovém adresáři aplikace ASP a každá aplikace může mít pouze jeden soubor Global.asa.
Soubor Global.asa může obsahovat pouze následující:
- Události aplikace
- Události relací
- deklarace <objektu>
- Deklarace TypeLibrary
- direktivu #include
Aplikace a události relace
V Global.asa můžete říci aplikaci a objektům relace, co mají dělat, když se aplikace/relace spustí, a co dělat, když aplikace/relace skončí. Kód pro toto je umístěn v obslužných rutinách událostí. Poznámka: Nepoužíváme <% a %>, pro vkládání skriptů do souboru Global.asa musíme podprogramy vložit do HTML tagu <script>:
<script language="vbscript" runat="server">
sub Application_OnStart
' nějaký kód
end sub
Application_OnEnd
' nějaký kód
end
sub Session_OnStart
' nějaký kód
end
sub Session_OnEnd
' nějaký kód
end sub
</script>
<objekt> Prohlášení
V Global.asa je také možné vytvořit objekty s rozsahem relace nebo aplikace pomocí tagu <object>. Poznámka: Značka <object> by měla být mimo značku <script>!
Syntax:
<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>
Prohlášení TypeLibrary
TypeLibrary je kontejner pro obsah souboru DLL odpovídající objektu COM. Zahrnutím volání TypeLibrary do souboru Global.asa lze přistupovat ke konstantám objektu COM a kódem ASP lze lépe hlásit chyby. Pokud vaše webová aplikace spoléhá na objekty COM, které deklarovaly datové typy v knihovnách typů, můžete deklarovat knihovny typů v Global.asa.
Syntax:
<!--METADATA TYPE="TypeLib"
file="název souboru"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->
Objekt relace
Objekt Session se používá k ukládání informací o uživatelské relaci nebo ke změně nastavení pro ni. Proměnné uložené v objektu Session obsahují informace o jednom uživateli a jsou dostupné všem stránkám v jedné aplikaci.
Sbírky
- Obsah – Obsahuje všechny položky přidané do relace pomocí příkazů skriptu
- StaticObjects – Obsahuje každý objekt přidaný do relace s tagem <object> a danou relaci
- Contents.Remove( item/index ) – Odstraní položku z kolekce Contents
- Contents.RemoveAll() – odstraní všechny položky z kolekce Contents
Vlastnosti
- CodePage – Nastavuje kódovou stránku, která bude použita k zobrazení dynamického obsahu
- LCID – Nastavuje identifikátor národního prostředí, který bude použit k zobrazení dynamického obsahu
- SessionID – Vrátí ID relace
- Timeout – Nastavuje časový limit pro relaci
Metoda
- Abandon - Zabije každý objekt v objektu relace
Objekt aplikace
Skupina souborů ASP, které spolupracují při provádění nějakého účelu, se nazývá aplikace. Ke spojení těchto souborů se používá objekt Application v ASP. Všichni uživatelé sdílejí jeden aplikační objekt. Objekt Application by měl obsahovat informace, které budou použity mnoha stránkami v aplikaci (jako jsou informace o připojení k databázi).
Sbírky
- Obsah – Obsahuje všechny položky přidané do aplikace pomocí příkazů skriptu
- StaticObjects – Obsahuje každý objekt přidaný do aplikace s tagem <object>
- Contents.Remove – Odstraní položku z kolekce
- Contents.RemoveAll – Odstraní všechny položky z kolekce
Metody
- Zámek – zabrání uživateli ve změně vlastností objektu aplikace
- Odemknout – umožňuje uživateli změnit vlastnosti objektu aplikace
Objekt odezvy
Objekt odpovědi se používá k odeslání výstupu uživateli ze serveru.
Sbírka
- Cookies(name) – Nastavuje hodnotu cookie. Pokud soubor cookie neexistuje, bude vytvořen a bude mít zadanou hodnotu
Vlastnosti
- Buffer – zda se má výstup vyrovnávací paměti či nikoli. Když je výstup uložen do vyrovnávací paměti, server zadrží odpověď, dokud nebudou zpracovány všechny skripty serveru nebo dokud skript nezavolá metodu Flush nebo End. Pokud je tato vlastnost nastavena, měla by být před značkou <html> v souboru ASP
- CacheControl – Nastavuje, zda mohou proxy servery ukládat výstup do mezipaměti nebo ne. Při nastavení na Veřejné může být výstup ukládán do mezipaměti proxy serverem
- Charset( charset_name) – Nastaví název znakové sady (např. „ISO8859-1“) do záhlaví typu obsahu
- ContentType – Nastavuje typ obsahu HTTP (jako "text/html", "image/gif", "image/jpeg", "text/plain"). Výchozí je "text/html"
- Vyprší – nastavuje, jak dlouho bude stránka uložena do mezipaměti v prohlížeči, než vyprší její platnost
- ExpiresAbsolute – Nastavuje datum a čas, kdy vyprší platnost stránky uložené v mezipaměti prohlížeče
- IsClientConnected – Zkontroluje, zda je klient stále připojen k serveru
- Pics( pics_label ) – Přidá hodnotu do záhlaví odpovědi štítku pics
- Stav – Určuje hodnotu stavového řádku
Metody
- AddHeader( name, value ) – Přidá HTML hlavičku se zadanou hodnotou
- AppendToLog string – přidá řetězec na konec záznamu serveru
- BinaryWrite( data_to_write ) - Zapíše danou informaci bez jakékoli konverze znakové sady
- Clear – vymaže výstup z vyrovnávací paměti. Tuto metodu použijte ke zpracování chyb. Pokud Response.Buffer není nastaven na hodnotu true, způsobí tato metoda chybu běhu
- End - Zastaví zpracování skriptu a vrátí aktuální výsledek
- Flush - Okamžitě odešle výstup ve vyrovnávací paměti. Pokud Response.Buffer není nastaven na hodnotu true, způsobí tato metoda chybu běhu
- Redirect( url ) – Přesměruje uživatele na jinou adresu URL
- Write( data_to_write ) – Zapíše text uživateli
Objekt požadavku
Když prohlížeč požádá o stránku ze serveru, nazývá se to požadavek. Objekt požadavku se používá k získání informací od uživatele.
Sbírka
- ClientCertificate – Obsahuje hodnoty polí uložené v klientském certifikátu
- Cookies( name ) – Obsahuje hodnoty cookie
- Form( element_name ) - Obsahuje hodnoty formuláře (vstupu). Formulář musí používat metodu post
- QueryString( název_proměnné ) – Obsahuje hodnoty proměnných v řetězci dotazu
- ServerVariables( server_variable ) – Obsahuje hodnoty proměnných serveru
Vlastnictví
- TotalBytes – Obsahuje celkový počet bajtů, které klient odesílá v těle požadavku
Metoda
- BinaryRead – Načte data, která jsou odeslána na server z klienta jako součást požadavku na odeslání
Objekt serveru
Objekt Server se používá pro přístup k vlastnostem a metodám na serveru.
Vlastnictví
- ScriptTimeout – Nastavuje, jak dlouho může skript běžet, než bude ukončen
Metoda
- CreateObject( typ_objektu ) – Vytvoří instanci objektu
- Execute( path ) – Spustí soubor ASP z jiného souboru ASP. Po provedení volaného souboru ASP se ovládací prvek vrátí do původního souboru ASP
- GetLastError() – Vrátí objekt ASPError, který bude popisovat chybu, ke které došlo
- HTMLEncode( string ) – Aplikuje kódování HTML na řetězec
- MapPath( cesta ) – Mapuje relativní nebo virtuální cestu k fyzické cestě
- Transfer( path ) – Odešle všechny informace o stavu do jiného souboru ASP ke zpracování. Po přenosu se procedurální řízení nevrátí do původního souboru ASP
- URLEncode( string ) – Aplikuje pravidla pro kódování URL na řetězec
Zdroj: https://www.w3schools.com/asp/asp_quickref.asp