public connect(url:String, port:Number) : Boolean

指定された TCP ポートを使用して指定されたインターネットホストへの接続を確立し、接続が正常に開始されたかどうかにより true または false を返します。XMLSocket.connect() メソッドが返す値が true である場合、接続プロセスの初期段階は成功です。この後で、最終的な接続が成功したか失敗したかを判別するために XMLSocket.onConnect() メソッドが呼び出されます。XMLSocket.connect() メソッドが false を返した場合は、接続に失敗しています。

インターネットホストコンピュータのポート番号がわからない場合は、ネットワーク管理者に問い合わせてください。XMLSocket を 1024 以下のポートに接続するには、最初に System.security.loadPolicyFile() メソッドを使用して、ポリシーファイルをロードする必要があります。

host パラメータに対して null を指定した場合は、XMLSocket.connect() を呼び出す SWF ファイルが存在するホストに接続します。たとえば、www.example.com から SWF ファイルをダウンロードした場合、host パラメータに null を指定することは www.example.com の IP アドレスを入力することと同じです。

Flash Player 7 以降で SWF ファイルを実行している場合、host パラメータは正確に同じドメインに置かれている必要があります。たとえば、www.someDomain.com に置かれている SWF ファイルが、Flash Player 5 用にパブリッシュされていて、Flash Player 7 以降で実行される場合、www.someDomain.com に存在する SWF ファイルからしか変数をロードできません。異なるドメインから変数をロードする場合は、アクセスされる側の SWF ファイルをホスティングするサーバーにクロスドメインポリシーファイルを置いておく必要があります。

メモ : XMLSocket.connect() メソッドは、System.capabilities.hasXMLSocket が false である場合に false を返します。

パラメータ

url:String - ストリング。DNS の完全修飾ドメイン名、つまり aaa.bbb.ccc.ddd という形式の IP アドレスです。SWF ファイルが存在するホストサーバーに接続するために、null を指定することもできます。呼び出し元の SWF ファイルが Web ブラウザで実行されている場合、host は SWF ファイルと同じドメインに属している必要があります。

port:Number - 数値。接続の確立に使用するホスト上の TCP ポート番号です。

戻り値

Boolean - 接続に成功した場合は true、それ以外の場合は false を返します。

例

次の例では、SWF ファイルが存在するホストに XMLSocket.connect() メソッドを使用して接続し、接続が成功したか失敗したかを示す戻り値を trace() 関数を使用して表示します。

var socket:XMLSocket = new XMLSocket()
socket.onConnect = function (success:Boolean) {
    if (success) {
    trace ("接続に成功しました");
    } else {
    trace ("接続に失敗しました");
    }
}
if (!socket.connect(null, 2000)) {
    trace ("接続に失敗しました");
}

関連項目

onConnect (XMLSocket.onConnect ハンドラ), Array 関数, loadPolicyFile (security.loadPolicyFile メソッド)