Error

Paket	Üst Düzey
Sınıf	public dynamic class Error
Miras Alma	Error Object
Alt Sınıflar	ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Error sınıfı bir komut dosyasında oluşan bir hata hakkında bilgiler içerir. ActionScript 3.0 uygulamaları geliştirilirken Flash çalışma zamanının hata ayıklayıcı sürümünde derlenmiş kodunuzu çalıştırdığınızda, kodla ilgili sorunları gidermenize yardımcı olması için bir iletişim kutusu, Error türünün veya bir alt sınıfın istisnalarını görüntüler. Error yapıcı işlevini kullanarak bir Error nesnesi oluşturabilirsiniz. Genellikle, yeni bir Error nesnesini catch kod bloğu tarafından yakalanmış bir try kod bloğunun içinden atarsınız.

Ayrıca, Error sınıfının bir alt sınıfını oluşturabilir ve bu alt sınıfın örneklerini de atabilirsiniz.

Örnekleri görüntüle

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		errorID : int [salt okunur] Belirli bir hata mesajı ile ilişkili başvuru numarasını içerir.	Error
		message : String Error nesnesi ile ilişkili mesajı içerir.	Error
		name : String Error nesnesinin adını içerir.	Error

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		Error(message:String = "", id:int = 0) Yeni bir Error nesnesi oluşturur.	Error
		getStackTrace():String Hatanın oluştuğu zamanda, bir hata için dize şeklinde çağrı yığını döndürür.	Error
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String [geçersiz kıl] Varsayılan olarak "Error" dizesini veya tanımlıysa Error.message özelliğinde bulunan değeri döndürür.	Error
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object

Özellik Ayrıntısı

errorID

özellik

errorID:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Belirli bir hata mesajı ile ilişkili başvuru numarasını içerir. Özel bir Error nesnesi için bu sayı, yapıcıda verilen id parametresinden alınan değerdir.

Uygulama
public function get errorID():int

message

özellik

public var message:String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Error nesnesi ile ilişkili mesajı içerir. Varsayılan olarak bu özelliğin değeri "Error" şeklindedir. Error nesnesi oluştururken Error yapıcı işlevine hata dizesini ileterek bir message özelliği belirtebilirsiniz.

İlgili API Öğeleri

statements.html#throw
statements.html#try..catch..finally

name

özellik

public var name:String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Error nesnesinin adını içerir. Varsayılan olarak bu özelliğin değeri "Error" şeklindedir.

İlgili API Öğeleri

statements.html#throw
statements.html#try..catch..finally

Yapıcı Ayrıntı

()

Yapıcı

public function Error(message:String = "", id:int = 0)

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Yeni bir Error nesnesi oluşturur. message değeri belirtilirse, bunun değeri nesnenin Error.message özelliğine atanır.

Parametreler

	`message:String` (default = "") — Error nesnesiyle ilişkili bir dize; bu parametre isteğe bağlıdır.

	`id:int` (default = `0`) — Belirli bir hata mesajıyla ilişkili başvuru numarası.

İlgili API Öğeleri

statements.html#throw
statements.html#try..catch..finally

Örnek ( Bu örnek nasıl kullanılır? )

Şu örnek, Error() yapıcısını kullanarak err adlı yeni bir Error nesnesi oluşturur ve ardından "New Error Message" dizesini err nesnesine atar.

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

Yöntem Ayrıntısı

getStackTrace

()

yöntem

public function getStackTrace():String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Hatanın oluştuğu zamanda, bir hata için dize şeklinde çağrı yığını döndürür. Şu örnekte gösterildiği gibi, döndürülen değerin ilk satırı istisna nesnesini temsil eden dizedir; ardından yığın izleme öğeleri gelir:

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]

Aşağıdaki listeleme, bu yöntemin, Flash Player'ın hata ayıklayıcı bir sürümünde çağrıldığında geçerli olan değerini veya AIR Hata Ayıklama Başlatıcısı'nda (ADL) çalışan kodu gösterir. Kod, bir Flash Player veya AIR yayın sürümünde çalıştığında yığın izleme özelliği şu örnekte olduğu gibi dosya yolu ve satır numarası bilgileri olmaksızın sağlanır:

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()

Flash Player 11.4 ve önceki sürümleri ile AIR 3.4 ve önceki sürümleri için, yığın izlemeleri yalnızca kod Flash Player veya AIR Hata Ayıklama Başlatıcısı (ADL) hata ayıklama sürümünde çalıştığında kullanılabilir. Bu çalışma zamanlarının hata ayıklayıcı olmayan sürümlerinde, bu yöntem çağrıldığında null döndürülür.

Döndürür

String — Çağrı yığınını temsil eden bir dize.

toString

()

yöntem

override public function toString():String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Varsayılan olarak "Error" dizesini veya tanımlıysa Error.message özelliğinde bulunan değeri döndürür.

Döndürür

String — Hata mesajı.

İlgili API Öğeleri

Error.message
statements.html#throw
statements.html#try..catch..finally

Örnek ( Bu örnek nasıl kullanılır? )

Şu örnek, Error() yapıcısını kullanarak err adlı yeni bir Error nesnesi oluşturur ve ardından "New Error Message" dizesini err nesnesine atar. Son olarak, message özelliği "Yeni Hata Mesajı" dizesinin üzerine yazılan "Başka Bir Hata Mesajı" değerine ayarlanır.

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message

Örnekler Bu örnek nasıl kullanılır?

ErrorExample.as

Şu örnek, özel bir hatanın nasıl oluşturulabileceğini göstermek için ErrorExample sınıfını kullanır. Bu işlem, aşağıdaki adımlar uygulanarak gerçekleştirilir:

Array türündeki nullArray yerel değişkeni bildirilmiştir, ancak yeni bir Array nesnesinin hiç oluşturulmadığına dikkat edin.
Yapıcı, Error sınıfını genişleten CustomError sınıfıyla özel hata yakalayan bir hata işleme kod bölümü içinden push() yöntemini kullanarak, ilk değerleri atanmamış diziye bir değer yüklemeye çalışır.
CustomError sınıfı atıldığında yapıcı bunu yakalar ve trace() ifadesini kullanarak bir hata mesajını çıktı olarak verir.

package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

Error - AS3

Paketlerx

Dil Öğeleri

Ekler

Sınıflar x

errorID

message

name

Error

getStackTrace

toString