Skrócona instrukcja ASP
Skrócona instrukcja ASP z W3Schools. Wydrukuj i złóż do kieszeni.
Podstawowa składnia
Skrypty ASP są otoczone znakami <% i %>. Aby zapisać dane wyjściowe w przeglądarce:
<html>
<body>
<% response.write("Witaj świecie!") %>
</body>
</html>
Domyślnym językiem w ASP jest VBScript. Aby użyć innego języka skryptowego, wstaw specyfikację języka u góry strony ASP:
<%@ language="javascript" %>
<html>
<body>
<%
....
%>
Formularze i dane wejściowe użytkownika
Request.QueryString służy do zbierania wartości w postaci z method="get". Informacja wysyłana z formularza metodą GET jest widoczna dla wszystkich (będzie wyświetlana w pasku adresu przeglądarki) i posiada limity ilości informacji do wysłania.
Request.Form służy do zbierania wartości w formularzu z method="post". Informacje wysyłane z formularza metodą POST są niewidoczne dla innych i nie mają ograniczeń co do ilości informacji do wysłania.
Pliki cookie ASP
Plik cookie jest często używany do identyfikacji użytkownika. Plik cookie to mały plik, który serwer osadza na komputerze użytkownika. Za każdym razem, gdy ten sam komputer zażąda strony z przeglądarką, wyśle również plik cookie.
Do tworzenia plików cookies służy polecenie Response.Cookies:
<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="10 maja 2002"
%>
Uwaga: Polecenie Response.Cookies musi pojawić się PRZED tagiem <html>!
Polecenie „Zapytanie.Cookies” służy do pobrania wartości pliku cookie:
<%
fname=Request.Cookies("firstname")
response.write("Imię=" i fname)
%>
W tym pliki
Zawartość jednego pliku ASP można wstawić do innego pliku ASP, zanim serwer go wykona, za pomocą dyrektywy #include. Dyrektywa #include służy do tworzenia funkcji, nagłówków, stopek lub elementów, które będą ponownie używane na wielu stronach
Składnia:
<!--#include virtual="somefile.inc"-->
lub
<!--#include file ="somefile.inc"-->
Użyj słowa kluczowego virtual, aby wskazać ścieżkę rozpoczynającą się od katalogu wirtualnego. Jeśli plik o nazwie „header.inc” znajduje się w katalogu wirtualnym o nazwie /html, poniższy wiersz spowoduje wstawienie zawartości „header.inc”:
<!-- #include virtual ="/html/header.inc" -->
Użyj słowa kluczowego file, aby wskazać ścieżkę względną. Ścieżka względna zaczyna się od katalogu zawierającego plik dołączany. Jeśli masz plik w katalogu html, a plik "header.inc" znajduje się w html\headers, następująca linia wstawia "header.inc" do twojego pliku:
<!-- #include plik ="headers\header.inc" -->
Użyj słowa kluczowego file ze składnią (..\), aby dołączyć plik z katalogu wyższego poziomu.
Global.asa
Plik Global.asa jest plikiem opcjonalnym, który może zawierać deklaracje obiektów, zmiennych i metod, do których można uzyskać dostęp z każdej strony aplikacji ASP.
Uwaga: Plik Global.asa musi być przechowywany w katalogu głównym aplikacji ASP, a każda aplikacja może mieć tylko jeden plik Global.asa.
Plik Global.asa może zawierać tylko następujące elementy:
- Zdarzenia aplikacyjne
- Wydarzenia sesyjne
- <obiekt> deklaracje
- Deklaracje typu Library
- dyrektywa #include
Zdarzenia aplikacji i sesji
W Global.asa możesz powiedzieć aplikacji i obiektom sesji, co mają zrobić po uruchomieniu aplikacji/sesji i co zrobić po zakończeniu aplikacji/sesji. Kod do tego jest umieszczony w procedurach obsługi zdarzeń. Uwaga: Nie używamy <% i %>, aby wstawić skrypty do pliku Global.asa, musimy umieścić podprogramy wewnątrz tagu HTML <script>:
<script language="vbscript" runat="server">
sub Application_OnStart
' jakiś kod
koniec sub
sub Application_OnEnd
' jakiś kod
koniec sub
sub Session_OnStart
' jakiś kod
koniec sub
sub Session_OnEnd
' jakiś kod
koniec sub
</script>
<obiekt> Deklaracje
Możliwe jest również tworzenie obiektów o zasięgu sesji lub aplikacji w Global.asa za pomocą znacznika <object>. Uwaga: Znacznik <object> powinien znajdować się poza znacznikiem <script>!
Składnia:
<object runat="serwer" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>
Deklaracje typu Library
TypeLibrary to kontener na zawartość pliku DLL odpowiadającego obiektowi COM. Umieszczając wywołanie TypeLibrary w pliku Global.asa, można uzyskać dostęp do stałych obiektu COM, a błędy mogą być lepiej raportowane przez kod ASP. Jeśli Twoja aplikacja sieci Web opiera się na obiektach COM, które mają zadeklarowane typy danych w bibliotekach typów, możesz zadeklarować biblioteki typów w Global.asa.
Składnia:
<!--METADATA TYPE="TypeLib"
file="nazwa pliku"
uuid="typelibraryuuid"
version="numer wersji"
lcid="identyfikator lokalny"
-->
Obiekt sesji
Obiekt Session służy do przechowywania informacji lub zmiany ustawień sesji użytkownika. Zmienne przechowywane w obiekcie Session zawierają informacje o jednym użytkowniku i są dostępne dla wszystkich stron w jednej aplikacji.
Kolekcje
- Zawartość - Przechowuje każdy element dodany do sesji za pomocą poleceń skryptu
- StaticObjects — przechowuje każdy obiekt dodany do sesji ze znacznikiem <object> i daną sesję
- Contents.Remove( item/index ) — usuwa element z kolekcji Contents
- Contents.RemoveAll() — usuwa każdy element z kolekcji Contents
Nieruchomości
- CodePage - Ustawia stronę kodową, która będzie używana do wyświetlania treści dynamicznych
- LCID - Ustawia identyfikator ustawień regionalnych, który będzie używany do wyświetlania treści dynamicznych
- SessionID - Zwraca identyfikator sesji
- Limit czasu — Ustawia limit czasu sesji
metoda
- Abandon - Zabija każdy obiekt w obiekcie sesji
Obiekt aplikacji
Grupa plików ASP, które współpracują ze sobą w określonym celu, nazywana jest aplikacją. Obiekt Application w ASP jest używany do powiązania tych plików. Wszyscy użytkownicy współdzielą jeden obiekt Application. Obiekt Application powinien zawierać informacje, które będą używane przez wiele stron w aplikacji (np. informacje o połączeniu z bazą danych).
Kolekcje
- Zawartość - Przechowuje każdy element dodany do aplikacji za pomocą poleceń skryptu
- StaticObjects — przechowuje każdy obiekt dodany do aplikacji za pomocą tagu <object>
- Contents.Remove — usuwa element z kolekcji
- Contents.RemoveAll — usuwa każdy element z kolekcji
Metody
- Zablokuj — uniemożliwia użytkownikowi zmianę właściwości obiektu aplikacji
- Odblokuj — umożliwia użytkownikowi zmianę właściwości obiektu aplikacji
Obiekt odpowiedzi
Obiekt odpowiedzi służy do wysyłania danych wyjściowych z serwera do użytkownika.
Kolekcja
- Cookies(name) — ustawia wartość pliku cookie. Jeśli plik cookie nie istnieje, zostanie utworzony i przyjmie określoną wartość
Nieruchomości
- Bufor — czy buforować dane wyjściowe, czy nie. Gdy dane wyjściowe są buforowane, serwer wstrzyma odpowiedź, dopóki wszystkie skrypty serwera nie zostaną przetworzone lub dopóki skrypt nie wywoła metody Flush lub End. Jeśli ta właściwość jest ustawiona, powinna znajdować się przed znacznikiem <html> w pliku ASP
- CacheControl — określa, czy serwery proxy mogą buforować dane wyjściowe, czy nie. Po ustawieniu na Public, dane wyjściowe mogą być buforowane przez serwer proxy
- Charset( charset_name) - Ustawia nazwę zestawu znaków (np. "ISO8859-1") na nagłówek typu zawartości
- ContentType — ustawia typ zawartości HTTP (np. „text/html”, „image/gif”, „image/jpeg”, „text/plain”). Wartość domyślna to „text/html”
- Wygasa — określa, jak długo strona będzie buforowana w przeglądarce przed wygaśnięciem
- ExpiresAbsolute — ustawia datę i godzinę wygaśnięcia strony z pamięci podręcznej przeglądarki
- IsClientConnected — sprawdza, czy klient jest nadal połączony z serwerem
- Pics( pics_label ) - Dodaje wartość do nagłówka odpowiedzi na etykietę pics
- Status — określa wartość linii statusu
Metody
- AddHeader( nazwa, wartość ) - Dodaje nagłówek HTML z określoną wartością
- AppendToLog string — dodaje ciąg na końcu wpisu w dzienniku serwera
- BinaryWrite( data_to_write ) - Zapisuje podane informacje bez konwersji zestawu znaków
- Clear — czyści buforowane dane wyjściowe. Użyj tej metody do obsługi błędów. Jeśli Response.Buffer nie jest ustawiony na true, ta metoda spowoduje błąd w czasie wykonywania
- End — zatrzymuje przetwarzanie skryptu i zwraca bieżący wynik
- Flush — natychmiast wysyła buforowane dane wyjściowe. Jeśli Response.Buffer nie jest ustawiony na true, ta metoda spowoduje błąd w czasie wykonywania
- Redirect( url ) — przekierowuje użytkownika do innego adresu URL
- Write( data_to_write ) - Zapisuje tekst do użytkownika
Poproś o obiekt
Gdy przeglądarka prosi o stronę z serwera, nazywa się to żądaniem. Obiekt żądania służy do pobierania informacji od użytkownika.
Kolekcja
- ClientCertificate — przechowuje wartości pól przechowywane w certyfikacie klienta
- Cookies( name ) - przechowuje wartości plików cookie
- Form( nazwa_elementu ) — przechowuje wartości formularza (dane wejściowe). Formularz musi używać metody post
- QueryString( nazwa_zmiennej ) — przechowuje wartości zmiennych w ciągu zapytania
- ServerVariables( server_variable ) - przechowuje wartości zmiennych serwera
Nieruchomość
- TotalBytes — przechowuje całkowitą liczbę bajtów, które klient wysyła w treści żądania
metoda
- BinaryRead — pobiera dane wysyłane do serwera od klienta w ramach żądania pocztowego
Obiekt serwera
Obiekt serwera służy do uzyskiwania dostępu do właściwości i metod na serwerze.
Nieruchomość
- ScriptTimeout — Ustawia, jak długo skrypt może działać przed jego zakończeniem
metoda
- CreateObject( type_of_object ) - Tworzy instancję obiektu
- Execute( ścieżka ) — wykonuje plik ASP z wnętrza innego pliku ASP. Po wykonaniu wywoływanego pliku ASP kontrola powraca do oryginalnego pliku ASP
- GetLastError() — Zwraca obiekt ASPError opisujący zaistniały błąd
- HTMLEncode( string ) — stosuje kodowanie HTML do ciągu znaków
- MapPath( ścieżka ) — mapuje ścieżkę względną lub wirtualną na ścieżkę fizyczną
- Transfer( ścieżka ) — przesyła wszystkie informacje o stanie do innego pliku ASP w celu przetworzenia. Po przeniesieniu kontrola proceduralna nie jest zwracana do oryginalnego pliku ASP
- URLEncode( string ) — stosuje reguły kodowania adresów URL do ciągu znaków
Źródło: https://www.w3schools.com/asp/asp_quickref.asp