SocketChannel 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
面向流的连接套接字的可选通道。
[Android.Runtime.Register("java/nio/channels/SocketChannel", DoNotGenerateAcw=true)]
public abstract class SocketChannel : Java.Nio.Channels.Spi.AbstractSelectableChannel, IDisposable, Java.Interop.IJavaPeerable, Java.Nio.Channels.IByteChannel, Java.Nio.Channels.IGatheringByteChannel, Java.Nio.Channels.IScatteringByteChannel[<Android.Runtime.Register("java/nio/channels/SocketChannel", DoNotGenerateAcw=true)>]
type SocketChannel = class
inherit AbstractSelectableChannel
interface IByteChannel
interface IReadableByteChannel
interface IChannel
interface ICloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IWritableByteChannel
interface IGatheringByteChannel
interface IScatteringByteChannel- 继承
- 属性
- 实现
注解
面向流的连接套接字的可选通道。
通过调用此类的 方法之 #open open 一来创建套接字通道。 无法为任意预先存在的套接字创建通道。 新创建的套接字通道已打开，但尚未连接。 尝试在未连接的通道上调用 I/O 操作将导致 NotYetConnectedException 引发 。 套接字通道可以通过调用其 #connect connect 方法进行连接;一旦连接，套接字通道将保持连接状态，直到它关闭。 套接字通道是否已连接可以通过调用其 #isConnected isConnected 方法来确定。
套接字通道支持 非阻塞连接： 可以创建套接字通道，并且可以通过 方法启动 #connect connect 建立到远程套接字的链接的过程，以便稍后通过 #finishConnect finishConnect 方法完成。 可以通过调用 #isConnectionPending isConnectionPending 方法来确定连接操作是否正在进行。
套接字通道支持 异步关闭， 这类似于 类中指定的 Channel 异步关闭操作。 如果套接字的输入端被一个线程关闭，而另一个线程在套接字的通道上的读取操作中被阻止，则阻塞线程中的读取操作将完成而不读取任何字节，并将返回 -1。 如果套接字的输出端被一个线程关闭，而另一个线程在套接字的通道上的写入操作中被阻止，则被阻止的线程将收到 AsynchronousCloseException。
使用 #setOption(SocketOption,Object) setOption 方法配置套接字选项。 套接字通道支持以下选项：<blockquote><table class=“striped”<>描述文字 style=“display：none”>Socket options</描述文字><thead<>tr<>th scope=“col”>Option Name</th<>th scope=“col”>Description</th<>/tr></thead><tbody><tr<>th scope=“row”java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF></th><Td>套接字发送缓冲区 </td<>/tr>><<th scope=“row”<>java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF/th<>td> 套接字接收缓冲区<的大小 /td<>/tr<>th<>scope=“row”><java.net.StandardSocketOptions#SO_KEEPALIVE SO_KEEPALIVE/th><td> Keep connection alive </td<>/tr<>><th scope=“row”><java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR/th><td> Re-use address </td<>/tr><><th scope=“row”>java.net.StandardSocketOptions#SO_LINGER SO_LINGER<在阻止模式下<配置时，如果数据 (存在，则关闭时) /td<>/tr><><th scope=“row”java.net.StandardSocketOptions#TCP_NODELAY TCP_NODELAY<>/th<>td> 禁用 Nagle 算法 </td></tr></tbody></table></blockquote> 其他 (实现特定) 选项也可能受支持。><>
套接字通道可以安全地供多个并发线程使用。 它们支持并发读取和写入，但最多一个线程可以在任意给定时间读取，最多一个线程可以写入。 和 #connect connect#finishConnect finishConnect 方法相互同步，并且尝试在调用其中一种方法正在进行时启动读取或写入操作，将阻止该调用完成。
在 1.4 中添加。
的 java.nio.channels.SocketChannelJava 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
构造函数
| SocketChannel(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
| SocketChannel(SelectorProvider) |
初始化此类的新实例。 |
属性
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsBlocking |
指示此通道是否处于阻止模式。 (继承自 AbstractSelectableChannel) |
| IsConnected |
指示此通道的套接字是否已连接。 |
| IsConnectionPending |
指示此通道的套接字是否仍在尝试连接。 |
| IsOpen |
如果此通道处于打开状态，则返回 true。 (继承自 AbstractInterruptibleChannel) |
| IsRegistered |
指示此通道是否注册到一个或多个选择器。 (继承自 AbstractSelectableChannel) |
| JniIdentityHashCode |
面向流的连接套接字的可选通道。 (继承自 Object) |
| JniPeerMembers |
面向流的连接套接字的可选通道。 |
| LocalAddress |
面向流的连接套接字的可选通道。 |
| PeerReference |
面向流的连接套接字的可选通道。 (继承自 Object) |
| RemoteAddress |
面向流的连接套接字的可选通道。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不应直接从代码中使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不应直接从代码中使用。 |
方法
显式接口实现
| IJavaPeerable.Disposed() |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.Finalized() |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.JniManagedPeerState |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
面向流的连接套接字的可选通道。 (继承自 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
面向流的连接套接字的可选通道。 (继承自 Object) |
扩展方法
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
面向流的连接套接字的可选通道。 |
| GetJniTypeName(IJavaPeerable) |
面向流的连接套接字的可选通道。 |
| WriteAsync(IGatheringByteChannel, ByteBuffer[]) |
面向流的连接套接字的可选通道。 |
| WriteAsync(IGatheringByteChannel, ByteBuffer[], Int32, Int32) |
面向流的连接套接字的可选通道。 |
| ReadAsync(IReadableByteChannel, ByteBuffer) |
面向流的连接套接字的可选通道。 |
| ReadAsync(IScatteringByteChannel, ByteBuffer[]) |
面向流的连接套接字的可选通道。 |
| ReadAsync(IScatteringByteChannel, ByteBuffer[], Int32, Int32) |
面向流的连接套接字的可选通道。 |
| WriteAsync(IWritableByteChannel, ByteBuffer) |
面向流的连接套接字的可选通道。 |