SocketAsyncEventArgs.SetBuffer Methode

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

public:
 void SetBuffer(Memory<System::Byte> buffer);

public void SetBuffer (Memory<byte> buffer);

member this.SetBuffer : Memory<byte> -> unit

Public Sub SetBuffer (buffer As Memory(Of Byte))

Parameter

Hinweise

Diese Methode legt die MemoryBuffer -Eigenschaft auf den buffer -Parameter, die Count -Eigenschaft auf die buffer Länge und die Offset -Eigenschaft auf Null fest.

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

public:
 void SetBuffer(int offset, int count);

public void SetBuffer (int offset, int count);

member this.SetBuffer : int * int -> unit

Public Sub SetBuffer (offset As Integer, count As Integer)

Parameter

Ausnahmen

Hinweise

Die offset Parameter und count dürfen keine negativen Zahlen sein. Die Kombination der offset Parameter und count muss sich in grenzen des Pufferarrays in der Buffer -Eigenschaft befinden.

Diese Methode legt die Count -Eigenschaft auf den count -Parameter und die Offset -Eigenschaft auf den offset -Parameter fest. Wenn die Buffer Eigenschaft NULL ist, ignoriert diese Methode die offset Parameter und count und legt die Offset Eigenschaften und Count auf 0 fest.

Diese Methode ändert die Buffer Eigenschaft nicht.

Weitere Informationen

• Buffer
• Count
• Offset

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

Quelle:

SocketAsyncEventArgs.cs

public:
 void SetBuffer(cli::array <System::Byte> ^ buffer, int offset, int count);

public void SetBuffer (byte[] buffer, int offset, int count);

public void SetBuffer (byte[]? buffer, int offset, int count);

member this.SetBuffer : byte[] * int * int -> unit

Public Sub SetBuffer (buffer As Byte(), offset As Integer, count As Integer)

Parameter

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird ein einzelner großer Puffer erstellt, der aufgeteilt und Objekten zur Verwendung mit jedem Socket-E/A-Vorgang zugewiesen SocketAsyncEventArgs werden kann. Dadurch können Puffer problemlos wiederverwendet werden und vor fragmentiertem Heapspeicher geschützt werden.

// This class creates a single large buffer which can be divided up
// and assigned to SocketAsyncEventArgs objects for use with each
// socket I/O operation.
// This enables bufffers to be easily reused and guards against
// fragmenting heap memory.
//
// The operations exposed on the BufferManager class are not thread safe.
class BufferManager
{
    int m_numBytes;                 // the total number of bytes controlled by the buffer pool
    byte[] m_buffer;                // the underlying byte array maintained by the Buffer Manager
    Stack<int> m_freeIndexPool;     //
    int m_currentIndex;
    int m_bufferSize;

    public BufferManager(int totalBytes, int bufferSize)
    {
        m_numBytes = totalBytes;
        m_currentIndex = 0;
        m_bufferSize = bufferSize;
        m_freeIndexPool = new Stack<int>();
    }

    // Allocates buffer space used by the buffer pool
    public void InitBuffer()
    {
        // create one big large buffer and divide that
        // out to each SocketAsyncEventArg object
        m_buffer = new byte[m_numBytes];
    }

    // Assigns a buffer from the buffer pool to the
    // specified SocketAsyncEventArgs object
    //
    // <returns>true if the buffer was successfully set, else false</returns>
    public bool SetBuffer(SocketAsyncEventArgs args)
    {

        if (m_freeIndexPool.Count > 0)
        {
            args.SetBuffer(m_buffer, m_freeIndexPool.Pop(), m_bufferSize);
        }
        else
        {
            if ((m_numBytes - m_bufferSize) < m_currentIndex)
            {
                return false;
            }
            args.SetBuffer(m_buffer, m_currentIndex, m_bufferSize);
            m_currentIndex += m_bufferSize;
        }
        return true;
    }

    // Removes the buffer from a SocketAsyncEventArg object.
    // This frees the buffer back to the buffer pool
    public void FreeBuffer(SocketAsyncEventArgs args)
    {
        m_freeIndexPool.Push(args.Offset);
        args.SetBuffer(null, 0, 0);
    }
}

Hinweise

Die offset Parameter und count dürfen keine negativen Zahlen sein. Die Kombination aus den offset Parametern und count muss sich in grenzen des Datenarrays im buffer Parameter befinden.

Diese Methode legt die Buffer -Eigenschaft auf den buffer -Parameter, die Count -Eigenschaft auf den count -Parameter und die Offset -Eigenschaft auf den offset -Parameter fest.

Weitere Informationen

• Buffer
• Count
• Offset