Priority Property  
 
Gets and sets the priority assigned to the server.

Syntax

object.Priority [= priority ]

Remarks

The Priority property can be used to control the processor usage, memory and network bandwidth allocated by the server for client sessions. One of the following values may be specified:

Value Constant Description
0 httpPriorityBackground This priority significantly reduces the memory, processor and network resource utilization for the server. It is typically used with lightweight services running in the background that are designed for few client connections. Each client thread will be assigned a lower scheduling priority and will be frequently forced to yield execution to other threads.
1 httpPriorityLow This priority lowers the overall resource utilization for the client session and meters the processor utilization for the client session. Each client thread will be assigned a lower scheduling priority and will occasionally be forced to yield execution to other threads.
2 httpPriorityNormal The default priority which balances resource and processor utilization. It is recommended that most applications use this priority.
3 httpPriorityHigh This priority increases the overall resource utilization for each client session and their threads will be given higher scheduling priority. It is not recommended that this priority be used on a system with a single processor.
4 httpPriorityCritical This priority can significantly increase processor, memory and network utilization. Each client thread will be given higher scheduling priority and will be more responsive to network events. It is not recommended that this priority be used on a system with a single processor.

The httpPriorityNormal priority balances resource and network bandwidth utilization while ensuring that a single-threaded server application remains responsive to the user. Lower priorities reduce the overall resource utilization of the server at the expense of throughput.

Higher priority values increase the thread priority and processor utilization for each client session. You should only change the server priority if you understand the impact it will have on the system and have thoroughly tested your application. Configuring the server to run with a higher priority can have a negative effect on the performance of other programs running on the system.

Data Type

Integer (Int32)

See Also

Start Method