Find

Syntax

Value = object.Find( Label[, Labelstring][, StartAfter])

Description

Find a header field in the collection.

Part	Description
object	Evaluates to a HttpHeaderFields object.
Label	HttpLabelConstants. Specifies the symbolic name for the header label being added. Use httpNull if Value includes the label.
LabelString	Optional String. Specifies the label to find. Use this parameter to find a non-standard label (not available in HttpLabelConstants). When using this parameter, Label should be httpNull.
StartAfter	Optional Long. Indicates the index to start the search after. StartAfter is updated to reflect the index of the header field found.
Value	String. Value containing the value of the requested header field, without the label.

Remarks

This method searches the collection for a label. On return, StartAfter is updated to reflect the index of the label found, allowing you to find multiple header fields having the same label.

StartAfter cannot be a constant because the method updates its value. Providing a constant value for StartAfter generates a run-time error. Specifying StartAfter with a value of zero starts the search at the beginning of the collection. StartAfter is set to 0 and "" is returned if the item is not found.

Error Codes

The Clear method may generate the following error codes (refer to the ErrorConstants topic for a complete list of error codes):

ptInvalidParam1
ptInvalidParam3
ptNoBufferSpace

See Also

ParentRequest, ParentResponse, ParentSession, Cookie, DartStream., GetSessionVar, SetSessionVar.