ASP Hızlı Referans

CodeW3C.com'dan ASP Hızlı Referans. Çıkartın, cebinizde saklayın, her zaman kullanmak için.

Temel Gramer

ASP betiği <% ve %> ile çevrelenir. Böylece tarayıcıya içerik çıkarılır:

<html>
<body>
<% response.write("Merhaba Dünya!") %>
</body>
</html>

ASP'teki varsayılan dil VBScript'tir. Diğer bir betik dili kullanmak istiyorsanız, ASP sayfasının üstüne bir dil beyanı ekleyin:

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

Formlar ve Kullanıcı Girdileri

Request.QueryString, method="get" olan formlardaki değerleri toplamak için kullanılır. GET ile gönderilen bilgiler herkes için görünür (tarayıcı adres çubuğunda görüntülenir) ve gönderilen veri miktarına sınırlama vardır.

Request.Form, method="post" olan formlardaki değerleri toplamak için kullanılır. POST ile gönderilen form bilgileri diğer kişiler için görünmez ve gönderilen veri miktarına sınırlama yoktur.

ASP Çerezleri

Cookie, kullanıcıları tanımlamak için yaygın olarak kullanılır. Cookie, sunucunun kullanıcı bilgisayarına yerleştirdiği küçük bir dosya. Aynı bilgisayar, tarayıcı aracılığıyla belirli bir sayfa talep ettiğinde, cookie de gönderilir.

Response.Cookies komutu, cookie oluşturmak için kullanılır:

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

Açıklama: Response.Cookies komutu <html> etiketi öncesinde olmalıdır!

"Request.Cookies" komutu, cookie değerlerini geri almak için kullanılır:

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

Dosya İçe Aktarma

#include komutu ile, sunucu çalışmadan önce bir ASP dosyasının içeriğini diğer bir ASP dosyasına ekleyebilirsiniz. #include komutu, fonksiyonlar, sayfa başlığı, sayfa altlığı veya birden fazla sayfada tekrar kullanılan öğeler oluşturmak için kullanılır.

Sözdizimi:

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

veya

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

Lütfen yolun virtüel dizine başladığını belirtmek için anahtar kelime 'virtual' kullanın. Eğer "header.inc" adlı dosya /html adlı virtüel dizinde bulunuyorsa, aşağıdaki kod "header.inc" içeriğini ekler:

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

Anahtar kelime 'file' kullanarak dosya yolunu belirtin. Doğru yol, bu atıf dosyasını içeren dizinle başlar. Eğer dosyanız html dizininde ve "header.inc" dosyası html\headers dizininde ise, aşağıdaki kod "header.inc" dosyasının içeriğini dosyanıza ekler:

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

Daha yüksek seviye dizinindeki dosyaları çağırmak için anahtar kelime 'file' ve (..\) dilimi kullanın.

Global.asa

Global.asa dosyası seçmeli dosya, ASP uygulamasının her sayfası tarafından erişilebilen nesne beyanları, değişkenler ve yöntemleri içerebilir.

Yorum: Global.asa dosyası ASP uygulamanın kök dizininde bulunmalı ve her uygulama yalnızca bir Global.asa dosyasına sahip olabilir.

Global.asa dosyası yalnızca aşağıdaki içerikleri içerebilir:

  • Application olayları
  • Session olayları
  • <object> beyanı
  • TypeLibrary açıklaması
  • #include talimatı

Application ve Session olayları

Global.asa dosyasında, application ve session nesnelerinin application/session başlangıcında ve bitiminde ne yapacağını söyleyebilirsiniz. Bu görevi gerçekleştiren kod, olay işleyicilerinde yer alır.

Yorum: Global.asa dosyasına kod eklerken, <% ve %> kullanmayız, HTML <script> etiketi içine program bloğu yerleştirmeliyiz:

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

<object> beyanı

<object> etiketi kullanılarak, Global.asa dosyasında session veya application etki alanına sahip nesneler de oluşturulabilir.

Yorum: <object> etiketi, <script> etiketi dışında yer almalıdır!

Sözdizimi:

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

TypeLibrary açıklaması

TypeLibrary, COM nesnelerine karşılık gelen DLL dosyasının içerik kapısıdır. Global.asa dosyasına TypeLibrary çağrısını içermek, COM nesnelerinin sabitlerini erişmek ve ASP kodunun hataları hakkında daha iyi rapor vermek için kullanılır. Web uygulamanız, türden açıklanmış veri türlerine sahip COM nesnelerine bağımlısa, Global.asa'da bu türlibi açıklayabilirsiniz.

Sözdizimi:

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

Session nesnesi

Session nesnesi, kullanıcı session'ı hakkında bilgi depolamak veya ayarlarını değiştirmek için kullanılır. Session nesnesinde depolanan değişkenler, tek bir kullanıcı hakkında bilgi içerir ve bir uygulamanın tüm sayfaları tarafından erişilebilir.

Koleksiyon

  • Contents - Script komutları ile session'a eklenen tüm girdileri içerir
  • StaticObjects - HTML'nin <object> etiketi ile session'a eklenen tüm nesneleri içerir
  • Contents.Remove(item/index) - Contents koleksiyonundan bir proje siler
  • Contents.RemoveAll() - Contents koleksiyonundan tüm projeleri siler

Özellik

  • CodePage - Dinamik içeriği görüntülemek için kullanılan karakter kümesini belirtir
  • LCID - Dinamik içeriği görüntülemek için kullanılan bölge tanımlayıcıyı ayarlar
  • SessionID - Session kimliğini döndürür
  • Timeout - Session'in zaman aşımını ayarlar veya döndürür

Metod

  • Abandon - Session nesnesindeki tüm nesneleri iptal eder.

Application nesnesi

Bir görevi tamamlamak için birlikte çalışan bir grup ASP dosyasına bir uygulama denir. ASP'teki Application nesnesi, bu dosyaları bir araya getirmek için kullanılır. Tüm kullanıcılar bir Application nesnesi birleştirir. Application nesnesi, uygulamadaki birçok sayfa tarafından kullanılan bilgileri (örneğin, veritabanı bağlantı bilgileri) içermelidir.

Koleksiyon

  • İçerikler - Uygulamaya eklenen tüm projeleri içeren
  • StaticObjects - HTML <object> etiketi ile uygulamaya eklenen tüm nesneleri içerir
  • Contents.Remove - Bir öğeyi Contents koleksiyonundan siler
  • Contents.RemoveAll - Tüm öğeleri Contents koleksiyonundan siler

Metod

  • Lock - Kullanıcının Application nesnesindeki değişkenlerini değiştirmesini önler
  • Unlock - Kullanıcının Application nesnesindeki değişkenleri değiştirmesine izin verir

Response nesnesi

Response nesnesi, sunucudan kullanıcıya çıktı göndermek için kullanılır

Koleksiyon

Cookies(name) - Cookie'nin değerini ayarlar. Eğer yoksa, oluşturur ve belirtilen değeri ayarlar

Özellik

  • Buffer - Çıktıyı Buffered olarak ayarlar. Çıktı Buffered olarak ayarlandığında, sunucu tarayıcıya yanıtı gönderirken tüm sunucu betiklerinin işlenmesini bekler veya Flush veya End yöntemini çağırır
  • CacheControl - ASP tarafından oluşturulan çıktıyı önbelleğe alabilir miyi ayarlar. Public olarak ayarlandığında, önbelleğe alınır
  • Charset(charset_name) - Karakter adının adını yanıt nesnesindeki content-type başlığına ekler
  • ContentType - Yanıt nesnesinin HTTP içeriği türünü ayarlar. Örneğin "text/html", "image/gif", "image/jpeg", "text/plain". Varsayılan "text/html"
  • Expires - Sayfanın geçersiz olana kadar tarayıcı önbelleğinde kalacak süreyi (dakika) ayarlar
  • ExpiresAbsolute - Tarayıcıdaki sayfa önbelleğinin geçersiz olacağı tarih ve zamanı ayarlar
  • IsClientConnected - İstemciyi sunucudan kesintiye uğramış olup olmadığını belirtir
  • Pics(pics_label) - Yanıt başlığı PICS bayrağına değer ekler
  • Status - Sunucunun döndüreceği durum satırının değerini belirler

Metod

  • AddHeader(name, value) - Yeni HTTP başlık ve değer eklemek için HTTP yanıtı
  • AppendToLog string - İstemsel sunucuya projenin (server log entry) sonuna bir dize ekler
  • BinaryWrite(data_to_write) - Karakter dönüşümü olmadan doğrudan çıktıya veri yazar
  • Clear - Tutarlı çıktıyı temizler. Hataları işlemek için bu yöntemi kullanın. Eğer Response.Buffer true olarak ayarlanmamışsa, bu yöntem çalışma zamanı hatası üretir
  • End - Skriptin işlenmesini durdurur ve mevcut sonucu döndürür
  • Flush - Tutarlı çıktıyı hemen gönderir. Eğer Response.Buffer true olarak ayarlanmamışsa, bu yöntem çalışma zamanı hatası üretir
  • Redirect(url) - Kullanıcıyı başka bir URL'ye yönlendirir
  • Write(data_to_write) - Kullanıcıya metin yazar

Request nesnesi

Tarayıcı sunucudan sayfa talep ettiğinde, bu durum request olarak adlandırılır. Request nesnesi, kullanıcıdan gelen bilgileri almak için kullanılır.

Koleksiyon

  • ClientCertificate - Müşteri sertifikasında depolanan alan değerlerini içerir
  • Cookies(name) - Cookie değerlerini içerir
  • Form(element_name) - Form değerlerini içerir. Bu form post yöntemi kullanılarak olmalıdır
  • QueryString(variable_name) - Sorgu dizgesindeki değişken değerlerini içerir
  • ServerVariables(server_variable) - Sunucu değişken değerlerini içerir

Özellik

  • TotalBytes - İstek metninde istemci tarafından gönderilen bayt toplamını döndürür

Metod

  • BinaryRead - İstemci tarafından sunucuya gönderilen post istemci verilerinin bir kısmını geri getirir

Server nesnesi

Server nesnesi, sunucudaki özelliklere ve metodlara erişmek için kullanılır.

Özellik

ScriptTimeout - Bir scriptin sonlandırılmadan önce ne kadar süre çalışabileceğini ayarlar veya döndürür.

Metod

  • CreateObject(type_of_object) - Nesnenin bir örneğini oluşturur
  • Execute(yol) - ASP dosyası içinden bir başka ASP dosyasını çalıştırır. Çağrılan ASP dosyası çalıştırıldıktan sonra, kontrol yetkisi önceki ASP dosyasına döner
  • ) - Oluşan hatayı tanımlayan ASPError nesnesini döndürür
  • HTMLEncode(string) - Dizgeye HTML kodlaması uygular
  • MapPath(yol) - Karşılık veya sanal yolun fiziksel yola haritalanmasını sağlar
  • Transfer(yol) - Tüm durum bilgilerini başka bir dosyaya gönderir, işlem için hazırlanır. Gönderimden sonra, programın kontrolü orijinal ASP dosyasına geri dönmez
  • URLEncode(string) - Dizgeye URL kodlama kuralları uygular

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