Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
flash.events 

AVHTTPStatusEvent  - AS3

パッケージflash.events
クラスpublic class AVHTTPStatusEvent
継承AVHTTPStatusEvent Inheritance Event Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

ネットワーク要求が HTTP ステータスコードを返すと、アプリケーションによって AVHTTPStatusEvent オブジェクトが送出されます。

AVHTTPStatusEvent オブジェクトは、常に、エラーイベントまたは完了イベントの前に送信されます。AVHTTPStatusEvent オブジェクトは、必ずしもエラー条件を示すわけではなく、ネットワークスタックによって提供される HTTP ステータスコード(ある場合)を反映します。Flash Player の環境によっては、HTTP ステータスコードを検出できないことがあります。このような場合は常に、ステータスコード 0 が報告されます。

Flash Player では、HTTPStatus イベントのタイプは httpStatus のみが存在します。AIR ランタイムでは、FileReference、URLLoader、URLStream のいずれかが httpResponseStatus を監視するように登録できます。このイベントは responseURL プロパティと responseHeaders プロパティを含みます。これらのプロパティは httpStatus イベントでは定義されていません。



パブリックプロパティ
 プロパティ定義元
 Inheritedbubbles : Boolean
[読み取り専用] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
 InheritedcurrentTarget : Object
[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritedeventPhase : uint
[読み取り専用] イベントフローの現在の段階です。
Event
  responseHeaders : Array
返された応答ヘッダー(URLRequestHeader オブジェクトの配列)です。
AVHTTPStatusEvent
  responseURL : String
応答の返送元の URL です。
AVHTTPStatusEvent
  status : int
[読み取り専用] サーバーから返された HTTP ステータスコードです。
AVHTTPStatusEvent
 Inheritedtarget : Object
[読み取り専用] イベントターゲットです。
Event
 Inheritedtype : String
[読み取り専用] イベントのタイプです。
Event
パブリックメソッド
 メソッド定義元
  
AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)
HTTP ステータスイベントに関する特定の情報を含む Event オブジェクトを作成します。
AVHTTPStatusEvent
  
[オーバーライド] AVHTTPStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
AVHTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
  
[オーバーライド] AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。
AVHTTPStatusEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
  AV_HTTP_RESPONSE_STATUS : String = "avHttpResponseStatus"
[静的] httpStatus イベントと異なり、httpResponseStatus イベントは応答データの前に配信されます。
AVHTTPStatusEvent
プロパティの詳細

responseHeaders

プロパティ
responseHeaders:Array

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Lite 4

返された応答ヘッダー(URLRequestHeader オブジェクトの配列)です。



実装
    public function get responseHeaders():Array
    public function set responseHeaders(value:Array):void

関連する API エレメント

responseURL

プロパティ 
responseURL:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Lite 4

応答の返送元の URL です。リダイレクトされた場合、これは要求した URL とは異なる URL になります。



実装
    public function get responseURL():String
    public function set responseURL(value:String):void

status

プロパティ 
status:int  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

サーバーから返された HTTP ステータスコードです。例えば、値 404 は、要求された URI と一致する URI が見つからなかったことを示します。HTTP ステータスコードは、HTTP 仕様の 10.4 および 10.5(http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)で確認できます。

Flash Player または AIR がサーバーからステータスコードを取得できなかった場合、またはサーバーと通信できなかった場合は、記述したコードにデフォルト値の 0 が渡されます。 値 0 は、どのプレーヤーでも生成される可能性があります(例えば、正しくない形式の URL が要求された場合など)。また、特定のブラウザーで実行される Flash Player プラグインでは、HTTP ステータスコードをプレーヤーに渡すことができないので、常に値 0 が生成されます。該当するブラウザーには、Netscape、Mozilla、Safari、Opera および Internet Explorer for the Macintosh があります。



実装
    public function get status():int
コンストラクターの詳細

AVHTTPStatusEvent

()コンストラクター
public function AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

HTTP ステータスイベントに関する特定の情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。

パラメーター
type:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。HTTPStatus イベントのタイプは AVHTTPStatusEvent.HTTP_STATUS の 1 つのみです。
 
bubbles:Boolean (default = false) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。イベントリスナーは、継承された bubbles プロパティを通じてこの情報にアクセスできます。
 
cancelable:Boolean (default = false) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。
 
status:int (default = 0) — 数値ステータスです。イベントリスナーは、status プロパティを通じてこの情報にアクセスできます。
 
responseUrl:String (default = null)
 
responseHeaders:Array (default = null)

関連する API エレメント

メソッドの詳細

clone

()メソッド
override public function clone():Event

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

AVHTTPStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

戻り値
Event — 元のオブジェクトと同じプロパティ値を含む新しい AVHTTPStatusEvent オブジェクトです。

toString

()メソッド 
override public function toString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

[AVHTTPStatusEvent type=value bubbles=value cancelable=value status=value]

戻り値
String — AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングです。
定数の詳細

AV_HTTP_RESPONSE_STATUS

定数
public static const AV_HTTP_RESPONSE_STATUS:String = "avHttpResponseStatus"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Lite 4

httpStatus イベントと異なり、httpResponseStatus イベントは応答データの前に配信されます。また、httpResponseStatus イベントには responseHeaders プロパティと responseURL プロパティの値が含まれます(これらは httpStatus イベントでは定義されていません)。httpResponseStatus イベントは、発生した場合、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

AVHTTPStatusEvent.HTTP_RESPONSE_STATUS 定数は、type プロパティ(httpResponseStatus イベントオブジェクト)の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
responseURL応答の返送元の URL です。
responseHeaders返された応答ヘッダー(URLRequestHeader オブジェクトの配列)です。
statusサーバーから返された HTTP ステータスコードです。
targetHTTP ステータスコードを受け取るネットワークオブジェクトです。

関連する API エレメント





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。