SocketAsyncEventArgs.SetBuffer Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği başlatır.

Aşırı Yüklemeler

Name	Description
SetBuffer(Memory<Byte>)	Zaman uyumsuz yuva yöntemiyle arabellek olarak kullanılacak bellek bölgesini ayarlar.
SetBuffer(Int32, Int32)	Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği ayarlar.
SetBuffer(Byte[], Int32, Int32)	Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği ayarlar.

Açıklamalar

Bu yöntem, özelliğini null ve Count ve Offset özelliklerini sıfır olarak ayarlarBuffer.

SetBuffer(Memory<Byte>)

Kaynak:

SocketAsyncEventArgs.cs

Zaman uyumsuz yuva yöntemiyle arabellek olarak kullanılacak bellek bölgesini ayarlar.

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))

Parametreler

buffer

Memory<Byte>

Zaman uyumsuz yuva yöntemiyle arabellek olarak kullanılacak bellek bölgesi.

Açıklamalar

Bu yöntem özelliği parametresine, özelliği uzunluğuna buffer ve Offset özelliği sıfır olarak ayarlarMemoryBuffer.Countbuffer

SetBuffer(Int32, Int32)

Kaynak:

SocketAsyncEventArgs.cs

Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği ayarlar.

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)

Parametreler

offset

Int32

İşlemin başladığı veri arabelleğindeki bayt cinsinden uzaklık.

count

Int32

Arabellekte gönderilecek veya alınacak bayt cinsinden maksimum veri miktarı.

Özel durumlar

ArgumentOutOfRangeException

Bir bağımsız değişken aralık dışındaydı. Bu özel durum, parametre sıfırdan küçükse veya özelliğindeki Buffer dizinin uzunluğundan büyükse offset oluşur. Bu özel durum, parametresi sıfırdan küçükse veya özelliğindeki dizinin Buffer uzunluğundan büyükse offset ve parametresi çıkarılırsa count da oluşur.

Açıklamalar

offset ve count parametreleri negatif sayılar olamaz. ve count parametrelerinin offset birleşimi, özelliğindeki arabellek dizisinin sınırlarında Buffer olmalıdır.

Bu yöntem, özelliğini parametresinecount, özelliğini parametresine Offsetoffset ayarlarCount. Buffer Özellik null ise, bu yöntem ve count parametrelerini yoksayar offset ve ve Count özelliklerini 0 olarak ayarlarOffset.

Bu yöntem özelliğini değiştirmez Buffer .

Ayrıca bkz.

• Buffer
• Count
• Offset

SetBuffer(Byte[], Int32, Int32)

Kaynak:

SocketAsyncEventArgs.cs

Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği ayarlar.

public:
 void SetBuffer(cli::array <System::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)

Parametreler

buffer

Byte[]

Zaman uyumsuz bir yuva yöntemiyle kullanılacak veri arabelleği.

offset

Int32

İşlemin başladığı veri arabelleğindeki bayt cinsinden uzaklık.

count

Int32

Arabellekte gönderilecek veya alınacak bayt cinsinden maksimum veri miktarı.

Özel durumlar

ArgumentException

Belirsiz arabellekler belirtildi. Özellik de null değilse Buffer ve BufferList özellik de null değilse bu özel durum oluşur.

ArgumentOutOfRangeException

Bir bağımsız değişken aralık dışındaydı. Bu özel durum, parametre sıfırdan küçükse veya özelliğindeki Buffer dizinin uzunluğundan büyükse offset oluşur. Bu özel durum, parametresi sıfırdan küçükse veya özelliğindeki dizinin Buffer uzunluğundan büyükse offset ve parametresi çıkarılırsa count da oluşur.

Örnekler

Aşağıdaki kod örneği, her yuva G/Ç işlemiyle kullanılmak üzere bölünebilen ve nesnelere SocketAsyncEventArgs atanabilen tek bir büyük arabellek oluşturur. Bu, arabelleklerin kolayca yeniden kullanılmasını sağlar ve parçalanan yığın belleğine karşı koruma sağlar.

// 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);
    }
}

Açıklamalar

offset ve count parametreleri negatif sayılar olamaz. ve count parametrelerinin offset birleşimi, parametredeki veri dizisinin sınırlarında buffer olmalıdır.

Bu yöntem özelliği parametresine, özelliği parametresine count ve Offset özelliği parametresine offset ayarlarBuffer.Countbuffer

Ayrıca bkz.

• Buffer
• Count
• Offset