LocalConnection.send()

可用性

Flash Player 6。

用法

sending_lc.send (connectionName, method [, p1,...,pN])

参数

connectionName 一个字符串，对应于要与 sending_lc 通讯的 LocalConnection.connect() 命令中所指定的连接名称。 

method 一个字符串，指定要在接收方 LocalConnection 对象中调用的方法的名称。以下方法名称会导致该命令失败：send、connect、close、domain、onStatus 和 allowDomain。

p1,...pN 要传递给指定方法的可选参数。

返回

如果 Flash 可以执行请求，则返回布尔值 true；否则，返回 false。

注意：返回值为 true 并不一定表示 Flash 已成功连接到接收方 LocalConnection 对象，而只表示该命令在语句构成上正确。若要确定连接是否成功，请参见 LocalConnection.onStatus。

说明

方法；在用 LocalConnection.connect(connectionName) 命令（称作“接收方 LocalConnection 对象”）打开的连接上调用名为 method 的方法。与此命令一起使用的对象称作“发送方 LocalConnection 对象”。包含发送方对象的 SWF 文件和包含接收方对象的 SWF 文件必须在同一台客户机上运行。  

您能够以参数形式传递给此命令的数据量是有限的。如果该命令返回 false 但您的语法却是正确的，请尝试将 LocalConnection.send() 请求拆分成多个命令。

如 LocalConnection.connect() 条目所述，Flash 在默认情况下会将当前超域添加到
connectionName。如果您在不同的域之间实现通讯，则需要在发送方 LocalConnection 对象中以及接收方 LocalConnection 对象中定义 connectionName，使 Flash 不会将当前超域添加到 connectionName。这可以通过两种方法来实现：

• 在发送方 LocalConnection 对象和接收方 LocalConnection 对象中 connectionName 的开头使用下划线 (_)。在包含接收方对象的 SWF 文件中，使用 LocalConnection.allowDomain 指定将接受来自任何域的连接。这一实现使您可以存储任何域中的发送方 SWF 文件和接收方 SWF 文件。
• 将 connectionName 中的超域包含在发送方 LocalConnection 对象中，例如
  myDomain.com:myConnectionName。在接收方对象中，使用 LocalConnection.allowDomain 指定将接受来自指定超域的连接（本例中为 myDomain.com），或者将接受来自任何域的连接。

注意：不能在接收方 LocalConnection 对象（只能在发送方 LocalConnection 对象）中指定
connectionName 中的超域。

示例

有关位于同一个域中的 LocalConnection 对象之间的通讯的示例，请参见
LocalConnection.connect()。有关位于任何域的 LocalConnection 对象之间的通讯的示例，请参见 LocalConnection.allowDomain。有关位于指定域的 LocalConnection 对象之间的通讯的示例，请参见 LocalConnection.allowDomain 和 LocalConnection.domain()。

另请参见

LocalConnection.allowDomain、LocalConnection.connect()、
LocalConnection.domain()、LocalConnection.onStatus