SocketAsyncEventArgs 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| SocketAsyncEventArgs() |
會產生一個空 SocketAsyncEventArgs 實例。 |
| SocketAsyncEventArgs(Boolean) |
初始化 SocketAsyncEventArgs。 |
SocketAsyncEventArgs()
會產生一個空 SocketAsyncEventArgs 實例。
public:
SocketAsyncEventArgs();
public SocketAsyncEventArgs();
Public Sub New ()
例外狀況
該平台不支援。
範例
以下程式碼範例代表一組可 SocketAsyncEventArgs 重用物件。
// Represents a collection of reusable SocketAsyncEventArgs objects.
class SocketAsyncEventArgsPool
{
Stack<SocketAsyncEventArgs> m_pool;
// Initializes the object pool to the specified size
//
// The "capacity" parameter is the maximum number of
// SocketAsyncEventArgs objects the pool can hold
public SocketAsyncEventArgsPool(int capacity)
{
m_pool = new Stack<SocketAsyncEventArgs>(capacity);
}
// Add a SocketAsyncEventArg instance to the pool
//
//The "item" parameter is the SocketAsyncEventArgs instance
// to add to the pool
public void Push(SocketAsyncEventArgs item)
{
if (item == null) { throw new ArgumentNullException("Items added to a SocketAsyncEventArgsPool cannot be null"); }
lock (m_pool)
{
m_pool.Push(item);
}
}
// Removes a SocketAsyncEventArgs instance from the pool
// and returns the object removed from the pool
public SocketAsyncEventArgs Pop()
{
lock (m_pool)
{
return m_pool.Pop();
}
}
// The number of SocketAsyncEventArgs instances in the pool
public int Count
{
get { return m_pool.Count; }
}
}
備註
呼叫此建構子後,所有屬性都會有其預設值:
物件參考將為 null
回傳整數的屬性會回傳零。
該 LastOperation 性質將等於 None。
屬性 SendPacketsFlags 等 TransmitFileOptions.UseDefaultWorkerThread於 ,表示不會使用任何旗標。
該 SocketFlags 性質將等於 None。
呼叫者必須先設定適當的屬性,才能將物件傳入適當的非同步套接字(xxxAsync)方法。
適用於
SocketAsyncEventArgs(Boolean)
初始化 SocketAsyncEventArgs。
public:
SocketAsyncEventArgs(bool unsafeSuppressExecutionContextFlow);
public SocketAsyncEventArgs(bool unsafeSuppressExecutionContextFlow);
new System.Net.Sockets.SocketAsyncEventArgs : bool -> System.Net.Sockets.SocketAsyncEventArgs
Public Sub New (unsafeSuppressExecutionContextFlow As Boolean)
參數
- unsafeSuppressExecutionContextFlow
- Boolean
是否要關閉執行上下文的擷取與流。 執行上下文流程只有在由高層處理時才應該被禁用。