EGDL2 2.1
|
Provides a collection of the HTTP headers associated with a request or response. More...
Inherits NameValueCollection, and ISerializable.
Public Member Functions | |
WebHeaderCollection () | |
Initializes a new instance of the WebHeaderCollection class. | |
void | Add (string header) |
Adds the specified header to the collection. | |
void | Add (HttpRequestHeader header, string value) |
Adds the specified request header with the specified value to the collection. | |
void | Add (HttpResponseHeader header, string value) |
Adds the specified response header with the specified value to the collection. | |
override void | Add (string name, string value) |
Adds a header with the specified name and value to the collection. | |
override void | Clear () |
Removes all headers from the collection. | |
override string | Get (int index) |
Get the value of the header at the specified index in the collection. | |
override string | Get (string name) |
Get the value of the header with the specified name in the collection. | |
override IEnumerator | GetEnumerator () |
Gets the enumerator used to iterate through the collection. | |
override string | GetKey (int index) |
Get the name of the header at the specified index in the collection. | |
override string[] | GetValues (int index) |
Gets an array of header values stored in the specified index position of the collection. | |
override string[] | GetValues (string header) |
Gets an array of header values stored in the specified header . | |
override void | GetObjectData (SerializationInfo serializationInfo, StreamingContext streamingContext) |
Populates the specified SerializationInfo with the data needed to serialize the WebHeaderCollection. | |
override void | OnDeserialization (object sender) |
Implements the ISerializable interface and raises the deserialization event when the deserialization is complete. | |
void | Remove (HttpRequestHeader header) |
Removes the specified request header from the collection. | |
void | Remove (HttpResponseHeader header) |
Removes the specified response header from the collection. | |
override void | Remove (string name) |
Removes the specified header from the collection. | |
void | Set (HttpRequestHeader header, string value) |
Sets the specified request header to the specified value. | |
void | Set (HttpResponseHeader header, string value) |
Sets the specified response header to the specified value. | |
override void | Set (string name, string value) |
Sets the specified header to the specified value. | |
byte[] | ToByteArray () |
Converts the current WebHeaderCollection to an array of byte. | |
override string | ToString () |
Returns a string that represents the current WebHeaderCollection. | |
Static Public Member Functions | |
static bool | IsRestricted (string headerName) |
Determines whether the specified header can be set for the request. | |
static bool | IsRestricted (string headerName, bool response) |
Determines whether the specified header can be set for the request or the response. | |
Protected Member Functions | |
WebHeaderCollection (SerializationInfo serializationInfo, StreamingContext streamingContext) | |
Initializes a new instance of the WebHeaderCollection class from the specified SerializationInfo and StreamingContext. | |
void | AddWithoutValidate (string headerName, string headerValue) |
Adds a header to the collection without checking whether the header is on the restricted header list. | |
Properties | |
override string[] | AllKeys [get] |
Gets all header names in the collection. | |
override int | Count [get] |
Gets the number of headers in the collection. | |
string | this[HttpRequestHeader header] [get, set] |
Gets or sets the specified request header in the collection. | |
string | this[HttpResponseHeader header] [get, set] |
Gets or sets the specified response header in the collection. | |
override NameObjectCollectionBase.KeysCollection | Keys [get] |
Gets a collection of header names in the collection. | |
Provides a collection of the HTTP headers associated with a request or response.
|
inlineprotected |
Initializes a new instance of the WebHeaderCollection class from the specified SerializationInfo and StreamingContext.
serializationInfo | A SerializationInfo that contains the serialized object data. |
streamingContext | A StreamingContext that specifies the source for the deserialization. |
ArgumentNullException | serializationInfo is null . |
ArgumentException | An element with the specified name isn't found in serializationInfo . |
|
inline |
Adds the specified request header with the specified value to the collection.
header | One of the HttpRequestHeader enum values, represents the request header to add. |
value | A string that represents the value of the header to add. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the request header . |
|
inline |
Adds the specified response header with the specified value to the collection.
header | One of the HttpResponseHeader enum values, represents the response header to add. |
value | A string that represents the value of the header to add. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the response header . |
|
inline |
Adds the specified header to the collection.
header | A string that represents the header with the name and value separated by a colon (: ). |
ArgumentNullException | header is null , empty, or the name part of header is empty. |
ArgumentException | header doesn't contain a colon. -or- header is a restricted header. -or- The name or value part of header contains invalid characters. |
ArgumentOutOfRangeException | The length of the value part of header is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the header . |
|
inline |
Adds a header with the specified name and value to the collection.
name | A string that represents the name of the header to add. |
value | A string that represents the value of the header to add. |
ArgumentNullException | name is null or empty. |
ArgumentException | name or value contains invalid characters. -or- name is a restricted header name. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the header name . |
|
inlineprotected |
Adds a header to the collection without checking whether the header is on the restricted header list.
headerName | A string that represents the name of the header to add. |
headerValue | A string that represents the value of the header to add. |
ArgumentNullException | headerName is null or empty. |
ArgumentException | headerName or headerValue contains invalid characters. |
ArgumentOutOfRangeException | The length of headerValue is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the headerName . |
|
inline |
Get the value of the header at the specified index in the collection.
index | An int that represents the zero-based index of the header to find. |
ArgumentOutOfRangeException | index is out of allowable range of indexes for the collection. |
|
inline |
Get the value of the header with the specified name in the collection.
null
. name | A string that represents the name of the header to find. |
|
inline |
Gets the enumerator used to iterate through the collection.
|
inline |
Get the name of the header at the specified index in the collection.
index | An int that represents the zero-based index of the header to find. |
ArgumentOutOfRangeException | index is out of allowable range of indexes for the collection. |
|
inline |
Populates the specified SerializationInfo with the data needed to serialize the WebHeaderCollection.
serializationInfo | A SerializationInfo that holds the serialized object data. |
streamingContext | A StreamingContext that specifies the destination for the serialization. |
ArgumentNullException | serializationInfo is null . |
FIXME: Removed to avoid Unity warning [SecurityPermission ( SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.SerializationFormatter)]
|
inline |
Gets an array of header values stored in the specified index position of the collection.
null
. index | An int that represents the zero-based index of the header to find. |
ArgumentOutOfRangeException | index is out of allowable range of indexes for the collection. |
|
inline |
Gets an array of header values stored in the specified header .
null
. header | A string that represents the name of the header to find. |
|
inlinestatic |
Determines whether the specified header can be set for the request.
true
if the header is restricted; otherwise, false
. headerName | A string that represents the name of the header to test. |
ArgumentNullException | headerName is null or empty. |
ArgumentException | headerName contains invalid characters. |
|
inlinestatic |
Determines whether the specified header can be set for the request or the response.
true
if the header is restricted; otherwise, false
. headerName | A string that represents the name of the header to test. |
response | true if does the test for the response; for the request, false . |
ArgumentNullException | headerName is null or empty. |
ArgumentException | headerName contains invalid characters. |
|
inline |
Implements the ISerializable interface and raises the deserialization event when the deserialization is complete.
sender | An object that represents the source of the deserialization event. |
|
inline |
Removes the specified request header from the collection.
header | One of the HttpRequestHeader enum values, represents the request header to remove. |
ArgumentException | header is a restricted header. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the request header . |
|
inline |
Removes the specified response header from the collection.
header | One of the HttpResponseHeader enum values, represents the response header to remove. |
ArgumentException | header is a restricted header. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the response header . |
|
inline |
Removes the specified header from the collection.
name | A string that represents the name of the header to remove. |
ArgumentNullException | name is null or empty. |
ArgumentException | name contains invalid characters. -or- name is a restricted header name. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the header name . |
|
inline |
Sets the specified request header to the specified value.
header | One of the HttpRequestHeader enum values, represents the request header to set. |
value | A string that represents the value of the request header to set. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the request header . |
|
inline |
Sets the specified response header to the specified value.
header | One of the HttpResponseHeader enum values, represents the response header to set. |
value | A string that represents the value of the response header to set. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the response header . |
|
inline |
Sets the specified header to the specified value.
name | A string that represents the name of the header to set. |
value | A string that represents the value of the header to set. |
ArgumentNullException | name is null or empty. |
ArgumentException | name or value contains invalid characters. -or- name is a restricted header name. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the header name . |
|
inline |
Converts the current WebHeaderCollection to an array of byte.
|
inline |
Returns a string that represents the current WebHeaderCollection.
|
get |
Gets all header names in the collection.
An array of string that contains all header names in the collection.
|
get |
Gets the number of headers in the collection.
An int that represents the number of headers in the collection.
|
get |
Gets a collection of header names in the collection.
A NameObjectCollectionBase.KeysCollection that contains all header names in the collection.
|
getset |
Gets or sets the specified request header in the collection.
A string that represents the value of the request header .
header | One of the HttpRequestHeader enum values, represents the request header to get or set. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the request header . |
|
getset |
Gets or sets the specified response header in the collection.
A string that represents the value of the response header .
header | One of the HttpResponseHeader enum values, represents the response header to get or set. |
ArgumentException | header is a restricted header. -or- value contains invalid characters. |
ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
InvalidOperationException | The current WebHeaderCollection instance doesn't allow the response header . |